Oggetto oggetto incorporato

Object XmlDocument

L'oggetto XmlDocument rappresenta l'intero documento XML

L'oggetto XmlDocument è la radice di un albero di documenti, che ci fornisce l'accesso iniziale (o più in alto) ai dati del documento. Per i nodi di elementi, i nodi di testo, i commenti, le istruzioni di elaborazione e così via, non possono esistere tutti al di fuori di XmlDocument e l'oggetto XmlDocument fornisce anche metodi per la creazione di questi oggetti. XmlNode oggetti XmlNode forniscono una proprietà ownerDocument che li associa all'XmlDocument in cui vengono creati.

Eredità

Costruttore

XmlDocument

Costruisci un oggetto XmlDocument

1
new XmlDocument(String type = "text/xml");

Parametri di chiamata:

  • type : String, specifica il tipo di oggetto documento, il valore predefinito è "text / xml ", se devi elaborare html, devi specificare "text / html"

Attributi dei membri

inputEncoding

Stringa, restituisce la codifica utilizzata per il documento (durante l'analisi)

1
readonly String XmlDocument.inputEncoding;

xmlStandalone

Booleano, imposta o restituisce se il documento è autonomo

1
Boolean XmlDocument.xmlStandalone;

xmlVersion

String, imposta o restituisci la versione XML del documento

1
String XmlDocument.xmlVersion;

doctype

XmlDocumentType , restituisce la dichiarazione del tipo di documento relativa al documento (Document Type Declaration)

1
readonly XmlDocumentType XmlDocument.doctype;

Per i documenti XML senza DTD, viene restituito null. Questo attributo fornisce l'accesso diretto all'oggetto XmlDocumentType (un nodo figlio di XmlDocument).


documentElement

XmlElement , restituisce il nodo radice del documento

1
readonly XmlElement XmlDocument.documentElement;

XmlElement , restituisce il nodo head del documento HTML, valido solo in modalità html

1
readonly XmlElement XmlDocument.head;

title

Stringa, restituisce il contenuto del nodo del titolo del documento HTML, valido solo in modalità html

1
readonly String XmlDocument.title;

body

XmlElement , restituisce il nodo del corpo del documento HTML, valido solo in modalità html

1
readonly XmlElement XmlDocument.body;

nodeType

Intero, restituisce il tipo di nodo del nodo

1
readonly Integer XmlDocument.nodeType;

Il nodeType di oggetti diversi restituirà valori diversi:


nodeName

Stringa, restituisce il nome del nodo, in base al suo tipo

1
readonly String XmlDocument.nodeName;

Il nodeName di oggetti diversi restituirà valori diversi:


nodeValue

Stringa, restituisce il nome del nodo, in base al suo tipo

1
String XmlDocument.nodeValue;

Il nodeName di oggetti diversi restituirà valori diversi:


ownerDocument

XmlDocument, restituisce l'elemento radice del nodo (oggetto XmlDocument)

1
readonly XmlDocument XmlDocument.ownerDocument;

parentNode

XmlNode , può restituire il nodo padre di un nodo

1
readonly XmlNode XmlDocument.parentNode;

childNodes

XmlNodeList , restituisce l'elenco dei nodi dei nodi figlio del nodo specificato

1
readonly XmlNodeList XmlDocument.childNodes;

firstChild

XmlNode , restituisce il primo nodo figlio del nodo

1
readonly XmlNode XmlDocument.firstChild;

lastChild

XmlNode , restituisce l'ultimo nodo figlio del nodo

1
readonly XmlNode XmlDocument.lastChild;

previousSibling

XmlNode , restituisce il nodo immediatamente prima di un nodo (allo stesso livello dell'albero), se non esiste tale nodo, questa proprietà restituisce null

1
readonly XmlNode XmlDocument.previousSibling;

nextSibling

XmlNode , restituisce il nodo immediatamente successivo a un elemento (nello stesso livello della struttura ad albero), se non esiste tale nodo, la proprietà restituisce null

1
readonly XmlNode XmlDocument.nextSibling;

Funzione membro

load

Componi il documento analizzando una stringa XML / HTML, non supporta il multilingue

1
XmlDocument.load(String source);

Parametri di chiamata:

  • source : String, il testo XML / HTML da analizzare, a seconda del tipo di documento quando è stato creato

Componi il documento analizzando una stringa XML / HTML binaria e convertilo automaticamente in base alla lingua

1
XmlDocument.load(Buffer source);

Parametri di chiamata:

  • source : Buffer , il testo XML / HTML da analizzare, dipende dal tipo di documento quando è stato creato

getElementsByTagName

Restituisce un elenco di nodi di tutti gli elementi con il nome specificato

1
XmlNodeList XmlDocument.getElementsByTagName(String tagName);

Parametri di chiamata:

  • tagName : String, il nome del tag da recuperare. Il valore "*" corrisponde a tutti i tag

Risultato di ritorno:

  • XmlNodeList , una raccolta di XmlNodeList di nodi XmlElement con tag specificati nella struttura ad albero del documento. L'ordine dei nodi degli elementi restituiti è l'ordine in cui appaiono nel documento di origine.

Questo metodo restituirà un oggetto XmlNodeList (che può essere elaborato come matrice di sola lettura), che archivia tutti i nodi XmlElement nel documento con il nome del tag specificato e l'ordine in cui sono archiviati è l'ordine in cui vengono visualizzati nel documento di origine. XmlNodeList oggetto XmlNodeList è "live", ovvero, se un elemento con un nome di tag specificato viene aggiunto o eliminato nel documento, il suo contenuto verrà aggiornato automaticamente secondo necessità.


getElementsByTagNameNS

Restituisce un elenco di nodi di tutti gli elementi con lo spazio dei nomi e il nome specificati

1 2
XmlNodeList XmlDocument.getElementsByTagNameNS(String namespaceURI, String localName);

Parametri di chiamata:

  • namespaceURI : String, specifica l'URI dello spazio dei nomi da recuperare. Il valore "*" può corrispondere a tutti i tag
  • localName : String, il nome dell'etichetta da recuperare. Il valore "*" corrisponde a tutti i tag

Risultato di ritorno:

  • XmlNodeList , una raccolta di XmlNodeList di nodi XmlElement con tag specificati nella struttura ad albero del documento. L'ordine dei nodi degli elementi restituiti è l'ordine in cui appaiono nel documento di origine.

Questo metodo è simile al metodo getElementsByTagName (), tranne per il fatto che recupera gli elementi in base allo spazio dei nomi e al nome.


getElementById

Restituisce l'elemento con l'attributo id specificato

1
XmlElement XmlDocument.getElementById(String id);

Parametri di chiamata:

  • id : String, id da recuperare

Risultato di ritorno:

Questo metodo attraverserà i nodi discendenti del documento e restituirà un oggetto nodo XmlElement che rappresenta il primo elemento del documento con l'attributo id specificato. .


getElementsByClassName

Restituisce un elenco di nodi di tutti gli elementi con il nome di classe specificato

1
XmlNodeList XmlDocument.getElementsByClassName(String className);

Parametri di chiamata:

  • className : String, il nome della classe da recuperare

Risultato di ritorno:

  • XmlNodeList , una raccolta XmlNodeList di nodi XmlElement con il nome di classe specificato nella struttura ad albero del documento. L'ordine dei nodi degli elementi restituiti è l'ordine in cui appaiono nel documento di origine.

Questo metodo restituirà un oggetto XmlNodeList (che può essere elaborato come array di sola lettura), che memorizza tutti i nodi XmlElement con il nome di classe specificato nel documento. L'ordine in cui sono archiviati è l'ordine in cui vengono visualizzati nel documento di origine. XmlNodeList oggetto XmlNodeList è "live", ovvero, se un elemento con un nome di tag specificato viene aggiunto o eliminato nel documento, il suo contenuto verrà aggiornato automaticamente secondo necessità.


createElement

Crea nodo elemento

1
XmlElement XmlDocument.createElement(String tagName);

Parametri di chiamata:

  • tagName : String, specifica il nome specificato del nodo dell'elemento

Risultato di ritorno:


createElementNS

Crea nodo elemento con lo spazio dei nomi specificato

1 2
XmlElement XmlDocument.createElementNS(String namespaceURI, String qualifiedName);

Parametri di chiamata:

  • namespaceURI : String, specifica l'URI dello spazio dei nomi del nodo dell'elemento
  • qualifiedName : String, il nome specificato del nodo dell'elemento specificato

Risultato di ritorno:


createTextNode

Crea nodo di testo

1
XmlText XmlDocument.createTextNode(String data);

Parametri di chiamata:

  • data : String, specifica il testo di questo nodo

Risultato di ritorno:

  • XmlText , restituisce il nodo XmlText appena creato, che rappresenta la stringa di dati specificata

createComment

Crea nodo commento

1
XmlComment XmlDocument.createComment(String data);

Parametri di chiamata:

  • data : String, specifica il testo del commento di questo nodo

Risultato di ritorno:

  • XmlComment , restituisce il nodo XmlComment appena creato, il testo del commento è i dati specificati

createCDATASection

Crea nodo XmlCDATASection

1
XmlCDATASection XmlDocument.createCDATASection(String data);

Parametri di chiamata:

  • data : stringa, specificare questo nodo per specificare i dati CDATA

Risultato di ritorno:


createProcessingInstruction

Crea nodo XmlProcessingInstruction

1 2
XmlProcessingInstruction XmlDocument.createProcessingInstruction(String target, String data);

Parametri di chiamata:

  • target : String, specifica la destinazione dell'istruzione di elaborazione
  • data : String, specifica il testo del contenuto dell'istruzione di elaborazione

Risultato di ritorno:


hasChildNodes

Interroga se sono presenti nodi figlio

1
Boolean XmlDocument.hasChildNodes();

Risultato di ritorno:

  • Boolean , restituisce true se sono presenti nodi figlio, altrimenti restituisce false

normalize

Unisci i nodi di testo adiacenti ed elimina i nodi di testo vuoti

1
XmlDocument.normalize();

Questo metodo attraverserà tutti i nodi discendenti del nodo corrente e normalizzerà il documento eliminando il nodo di testo vuoto e unendo tutti i nodi di testo adiacenti. Questo metodo è utile per semplificare la struttura dell'albero del documento dopo aver inserito o eliminato i nodi.


cloneNode

Crea una copia esatta del nodo specificato

1
XmlNode XmlDocument.cloneNode(Boolean deep = true);

Parametri di chiamata:

  • deep : Boolean, se eseguire la copia profonda, quando true, il nodo clonato clonerà tutti i nodi figlio del nodo originale

Risultato di ritorno:

  • XmlNode , restituisce il nodo copiato

Questo metodo copierà e restituirà una copia del nodo che lo ha chiamato. Se il parametro passato a esso è vero, copierà anche ricorsivamente tutti i discendenti del nodo corrente. In caso contrario, copia solo il nodo corrente. Il nodo restituito non appartiene alla struttura ad albero del documento e la sua proprietà parentNode è null. Quando il nodo Elemento viene copiato, verranno copiati tutti i suoi attributi.


lookupPrefix

Restituisce il prefisso corrispondente all'URI dello spazio dei nomi specificato sul nodo corrente

1
String XmlDocument.lookupPrefix(String namespaceURI);

Parametri di chiamata:

  • namespaceURI : stringa, specifica l'URI dello spazio dei nomi corrispondente

Risultato di ritorno:

  • String , restituisce il prefisso corrispondente, restituisce null se non corrisponde

lookupNamespaceURI

Restituisce l'URI dello spazio dei nomi che corrisponde al prefisso specificato sul nodo corrente

1
String XmlDocument.lookupNamespaceURI(String prefix);

Parametri di chiamata:

  • prefix : String, specifica il prefisso corrispondente

Risultato di ritorno:

  • String , restituisce l'URI dello spazio dei nomi corrispondente, restituisce null se non corrisponde

insertBefore

Inserisci un nuovo nodo figlio prima del nodo figlio esistente

1 2
XmlNode XmlDocument.insertBefore(XmlNode newChild, XmlNode refChild);

Parametri di chiamata:

  • newChild : XmlNode , inserisci un nuovo nodo
  • refChild : XmlNode , inserisci un nuovo nodo prima di questo nodo

Risultato di ritorno:

  • XmlNode , restituisce il nuovo nodo figlio

Se newChild esiste già nell'albero del documento, verrà eliminato dall'albero del documento e quindi reinserito nella sua nuova posizione. I nodi di un documento (o i nodi creati da un documento) non possono essere inseriti in un altro documento. In altre parole, la proprietà ownerDocument di newChild deve essere la stessa della proprietà ownerDocument del nodo corrente.


insertAfter

Inserisci un nuovo nodo figlio dopo il nodo figlio esistente

1 2
XmlNode XmlDocument.insertAfter(XmlNode newChild, XmlNode refChild);

Parametri di chiamata:

  • newChild : XmlNode , inserisci un nuovo nodo
  • refChild : XmlNode , inserisci un nuovo nodo dopo questo nodo

Risultato di ritorno:

  • XmlNode , restituisce il nuovo nodo figlio

Se newChild esiste già nell'albero del documento, verrà eliminato dall'albero del documento e quindi reinserito nella sua nuova posizione. I nodi di un documento (o i nodi creati da un documento) non possono essere inseriti in un altro documento. In altre parole, la proprietà ownerDocument di newChild deve essere uguale alla proprietà ownerDocument del nodo corrente.


appendChild

Aggiungi un nuovo nodo figlio alla fine dell'elenco dei nodi figlio del nodo

1
XmlNode XmlDocument.appendChild(XmlNode newChild);

Parametri di chiamata:

  • newChild : XmlNode , specifica il nodo aggiunto

Risultato di ritorno:

  • XmlNode , restituisce questo nuovo nodo figlio

Se newChild esiste già nell'albero del documento, verrà eliminato dall'albero del documento e quindi reinserito nella sua nuova posizione. I nodi di un documento (o i nodi creati da un documento) non possono essere inseriti in un altro documento. In altre parole, la proprietà ownerDocument di newChild deve essere la stessa della proprietà ownerDocument del nodo corrente.


replaceChild

Sostituisci un nodo figlio con un altro

1 2
XmlNode XmlDocument.replaceChild(XmlNode newChild, XmlNode oldChild);

Parametri di chiamata:

  • newChild : XmlNode , specifica un nuovo nodo
  • oldChild : XmlNode , specifica il nodo da sostituire

Risultato di ritorno:

  • XmlNode , se la sostituzione ha esito positivo, questo metodo può restituire il nodo sostituito, se la sostituzione non riesce, restituisce null

Se newChild esiste già nell'albero del documento, verrà eliminato dall'albero del documento e quindi reinserito nella sua nuova posizione. I nodi di un documento (o i nodi creati da un documento) non possono essere inseriti in un altro documento. In altre parole, la proprietà ownerDocument di newChild deve essere la stessa della proprietà ownerDocument del nodo corrente.


removeChild

Rimuovi un nodo dall'elenco dei nodi figlio

1
XmlNode XmlDocument.removeChild(XmlNode oldChild);

Parametri di chiamata:

  • oldChild : XmlNode , specifica il nodo da eliminare

Risultato di ritorno:

  • XmlNode , se l'eliminazione ha esito positivo, questo metodo può restituire il nodo eliminato, se non riesce, restituisce null

toString

Restituisce la rappresentazione in stringa dell'oggetto, generalmente restituisce "[Native Object]", l'oggetto può essere reimplementato secondo le proprie caratteristiche

1
String XmlDocument.toString();

Risultato di ritorno:

  • String , restituisce la rappresentazione in formato stringa dell'oggetto

toJSON

Restituisce la rappresentazione in formato JSON dell'oggetto, generalmente restituisce una raccolta di attributi leggibili definiti dall'oggetto

1
Value XmlDocument.toJSON(String key = "");

Parametri di chiamata:

  • key : stringa, non utilizzata

Risultato di ritorno:

  • Value , restituisce un valore contenente JSON serializzabile