Objekt eingebautes Objekt

Objekt XmlDocument

Das XmlDocument-Objekt repräsentiert das gesamte XML-Dokument

Das XmlDocument-Objekt ist das Stammverzeichnis eines Dokumentbaums und bietet uns den ersten (oder obersten) Zugriff auf die Dokumentdaten. Elementknoten, Textknoten, Kommentare, Verarbeitungsanweisungen usw. dürfen außerhalb von XmlDocument nicht vorhanden sein. XmlDocument-Objekte bieten auch Methoden zum Erstellen dieser Objekte. XmlNode Objekte stellen eine ownerDocument-Eigenschaft bereit, die sie dem XmlDocument zuordnet, in dem sie erstellt wurden.

Vererbung

Konstruktor

XmlDocument

Erstellen Sie ein XmlDocument-Objekt

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

Parameter aufrufen:

  • type : Zeichenfolge, geben Sie den Typ des Dokumentobjekts an. Standardmäßig ist "text / xml ". Wenn Sie HTML verarbeiten müssen, müssen Sie "text / html" angeben.

Mitgliedsattribute

inputEncoding

String, gibt die für das Dokument verwendete Codierung zurück (beim Parsen)

1
readonly String XmlDocument.inputEncoding;

xmlStandalone

Boolesch, festlegen oder zurückgeben, ob das Dokument eigenständig ist

1
Boolean XmlDocument.xmlStandalone;

xmlVersion

String, legt die XML-Version des Dokuments fest oder gibt sie zurück

1
String XmlDocument.xmlVersion;

doctype

XmlDocumentType gibt die Dokumenttypdeklaration zurück, die sich auf das Dokument bezieht

1
readonly XmlDocumentType XmlDocument.doctype;

Bei XML-Dokumenten ohne DTD wird null zurückgegeben. Diese Eigenschaft bietet direkten Zugriff auf ein XmlDocumentType Objekt (einen untergeordneten Knoten von XmlDocument).


documentElement

XmlElement gibt den XmlElement des Dokuments zurück

1
readonly XmlElement XmlDocument.documentElement;

XmlElement gibt den Hauptknoten des HTML-Dokuments zurück, der nur im HTML-Modus gültig ist

1
readonly XmlElement XmlDocument.head;

title

String, gibt den Inhalt des Titelknotens des HTML-Dokuments zurück, der nur im HTML-Modus gültig ist

1
readonly String XmlDocument.title;

body

XmlElement gibt den Hauptknoten eines HTML-Dokuments zurück, der nur im HTML-Modus gültig ist

1
readonly XmlElement XmlDocument.body;

nodeType

Ganzzahl, gibt den Knotentyp des Knotens zurück

1
readonly Integer XmlDocument.nodeType;

Der Knotentyp verschiedener Objekte gibt unterschiedliche Werte zurück:


nodeName

String, gibt den Namen des Knotens basierend auf seinem Typ zurück

1
readonly String XmlDocument.nodeName;

Der Knotenname verschiedener Objekte gibt unterschiedliche Werte zurück:


nodeValue

String, gibt den Namen des Knotens basierend auf seinem Typ zurück

1
String XmlDocument.nodeValue;

Der Knotenname verschiedener Objekte gibt unterschiedliche Werte zurück:


ownerDocument

XmlDocument, gibt das Stammelement des Knotens zurück (XmlDocument-Objekt)

1
readonly XmlDocument XmlDocument.ownerDocument;

parentNode

XmlNode , der das übergeordnete Element eines Knotens zurückgeben kann

1
readonly XmlNode XmlDocument.parentNode;

childNodes

XmlNodeList gibt die Knotenliste der XmlNodeList Knoten des angegebenen Knotens zurück

1
readonly XmlNodeList XmlDocument.childNodes;

firstChild

XmlNode , gibt das erste XmlNode des Knotens zurück

1
readonly XmlNode XmlDocument.firstChild;

lastChild

XmlNode gibt das letzte XmlNode des Knotens zurück

1
readonly XmlNode XmlDocument.lastChild;

previousSibling

XmlNode gibt den Knoten unmittelbar vor einem Knoten zurück (auf derselben XmlNode ). Wenn kein solcher Knoten vorhanden ist, gibt die Eigenschaft null zurück

1
readonly XmlNode XmlDocument.previousSibling;

nextSibling

XmlNode gibt den Knoten unmittelbar nach einem Element (in derselben XmlNode ) zurück. Wenn kein solcher Knoten vorhanden ist, gibt die Eigenschaft null zurück

1
readonly XmlNode XmlDocument.nextSibling;

Mitgliedsfunktion

load

Das Dokument wird durch Parsen einer XML / HTML-Zeichenfolge erstellt. Mehrsprachigkeit wird nicht unterstützt

1
XmlDocument.load(String source);

Parameter aufrufen:

  • source : String, der zu analysierende XML / HTML-Text, abhängig vom Typ, als das Dokument erstellt wurde

Das Dokument wird durch Parsen einer binären XML / HTML-Zeichenfolge erstellt und automatisch entsprechend der Sprache konvertiert

1
XmlDocument.load(Buffer source);

Parameter aufrufen:

  • source : Buffer , zu analysierender XML / HTML-Text, abhängig vom Typ, als das Dokument erstellt wurde

getElementsByTagName

Gibt eine Liste von Knoten mit allen Elementen mit dem angegebenen Namen zurück

1
XmlNodeList XmlDocument.getElementsByTagName(String tagName);

Parameter aufrufen:

  • tagName : String, der abzurufende Tag-Name. Der Wert "*" entspricht allen Tags

Gibt das Ergebnis zurück:

  • XmlNodeList , die XmlNodeList Auflistung von XmlElement Knoten mit den angegebenen Tags in der Dokumentstruktur. Die Reihenfolge der zurückgegebenen Elementknoten ist die Reihenfolge, in der sie im Quelldokument angezeigt werden.

Diese Methode gibt ein XmlNodeList Objekt zurück (das als schreibgeschütztes Array behandelt werden kann). Dieses Objekt speichert alle XmlElement Knoten mit dem angegebenen Tag-Namen im Dokument. Die Reihenfolge, in der sie gespeichert werden, ist die Reihenfolge, in der sie im Quelldokument XmlElement werden. XmlNodeList Objekt ist "live". Wenn also das Element mit dem angegebenen Tag-Namen zum Dokument hinzugefügt oder daraus entfernt wird, wird sein Inhalt bei Bedarf automatisch aktualisiert.


getElementsByTagNameNS

Gibt eine Liste von Knoten mit allen Elementen des angegebenen Namespace und Namens zurück

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

Parameter aufrufen:

  • namespaceURI : String, gibt den abzurufenden Namespace-URI an. Der Wert "*" entspricht allen Tags
  • localName : String, der abzurufende Tag-Name. Der Wert "*" entspricht allen Tags

Gibt das Ergebnis zurück:

  • XmlNodeList , die XmlNodeList Auflistung von XmlElement Knoten mit den angegebenen Tags in der Dokumentstruktur. Die Reihenfolge der zurückgegebenen Elementknoten ist die Reihenfolge, in der sie im Quelldokument angezeigt werden.

Diese Methode ähnelt der Methode getElementsByTagName (), mit der Ausnahme, dass Elemente basierend auf dem Namespace und dem Namen abgerufen werden.


getElementById

Gibt das Element mit dem angegebenen ID-Attribut zurück

1
XmlElement XmlDocument.getElementById(String id);

Parameter aufrufen:

  • id : String, die abzurufende ID

Gibt das Ergebnis zurück:

Diese Methode durchläuft die XmlElement Knoten des Dokuments und gibt ein XmlElement , das das erste Dokumentelement mit dem angegebenen ID-Attribut darstellt. .


getElementsByClassName

Gibt eine Knotenliste aller Elemente mit dem angegebenen Klassennamen zurück

1
XmlNodeList XmlDocument.getElementsByClassName(String className);

Parameter aufrufen:

  • className : String, der Name der Klasse, die abgerufen werden soll

Gibt das Ergebnis zurück:

  • XmlNodeList , die XmlNodeList Auflistung von XmlElement Knoten mit dem angegebenen Klassennamen in der Dokumentstruktur. Die Reihenfolge der zurückgegebenen Elementknoten ist die Reihenfolge, in der sie im Quelldokument angezeigt werden.

Diese Methode gibt ein XmlNodeList Objekt zurück (das als schreibgeschütztes Array behandelt werden kann). Dieses Objekt speichert alle XmlElement Knoten mit dem angegebenen Klassennamen im Dokument. Die Reihenfolge, in der sie gespeichert werden, entspricht der Reihenfolge, in der sie im Quelldokument XmlElement werden. XmlNodeList Objekt ist "live". Wenn also das Element mit dem angegebenen Tag-Namen zum Dokument hinzugefügt oder daraus entfernt wird, wird sein Inhalt bei Bedarf automatisch aktualisiert.


createElement

Elementknoten erstellen

1
XmlElement XmlDocument.createElement(String tagName);

Parameter aufrufen:

  • tagName : String, der angegebene Name des angegebenen Elementknotens

Gibt das Ergebnis zurück:


createElementNS

Erstellen Sie einen Elementknoten mit dem angegebenen Namespace

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

Parameter aufrufen:

  • namespaceURI : String, gibt den Elementknoten-Namespace-URI an
  • qualifiedName Name: String, der angegebene Name des angegebenen Elementknotens

Gibt das Ergebnis zurück:


createTextNode

Erstellen Sie einen Textknoten

1
XmlText XmlDocument.createTextNode(String data);

Parameter aufrufen:

  • data : String, gibt den Text dieses Knotens an

Gibt das Ergebnis zurück:


createComment

Erstellen Sie einen Anmerkungsknoten

1
XmlComment XmlDocument.createComment(String data);

Parameter aufrufen:

  • data : String, gibt den Kommentartext für diesen Knoten an

Gibt das Ergebnis zurück:

  • XmlComment gibt den neu erstellten XmlComment Knoten zurück. Der Kommentartext enthält die angegebenen Daten

createCDATASection

Erstellen Sie den XmlCDATASection Knoten

1
XmlCDATASection XmlDocument.createCDATASection(String data);

Parameter aufrufen:

  • data : String, gibt an, dass dieser Knoten CDATA-Daten angibt

Gibt das Ergebnis zurück:


createProcessingInstruction

Erstellen Sie den XmlProcessingInstruction Knoten

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

Parameter aufrufen:

  • target : String, gibt das Ziel der Verarbeitungsanweisung an
  • data : String, der Text der angegebenen Verarbeitungsanweisung

Gibt das Ergebnis zurück:


hasChildNodes

Fragen Sie ab, ob untergeordnete Knoten vorhanden sind

1
Boolean XmlDocument.hasChildNodes();

Gibt das Ergebnis zurück:

  • Boolean , gibt true zurück, wenn untergeordnete Knoten vorhanden sind, andernfalls false

normalize

Füge benachbarte Textknoten zusammen und lösche leere Textknoten

1
XmlDocument.normalize();

Diese Methode durchläuft alle untergeordneten Knoten des aktuellen Knotens und normalisiert das Dokument, indem leere Textknoten entfernt und alle benachbarten Textknoten zusammengeführt werden. Diese Methode ist nützlich, um die Struktur des Dokumentbaums nach dem Einfügen oder Löschen von Knoten zu vereinfachen.


cloneNode

Erstellen Sie eine genaue Kopie des angegebenen Knotens

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

Parameter aufrufen:

  • deep : Boolean, ob tief kopiert werden soll. Wenn true, klont der geklonte Knoten alle untergeordneten Knoten des ursprünglichen Knotens.

Gibt das Ergebnis zurück:

  • XmlNode gibt den kopierten Knoten zurück

Diese Methode kopiert und gibt eine Kopie des Knotens zurück, der sie aufgerufen hat. Wenn das an ihn übergebene Argument wahr ist, werden auch alle untergeordneten Knoten des aktuellen Knotens rekursiv kopiert. Andernfalls wird nur der aktuelle Knoten kopiert. Der zurückgegebene Knoten gehört nicht zum Dokumentbaum, und seine parentNode-Eigenschaft ist null. Wenn ein Elementknoten kopiert wird, werden alle seine Attribute kopiert.


lookupPrefix

Gibt das Präfix zurück, das dem angegebenen Namespace-URI auf dem aktuellen Knoten entspricht

1
String XmlDocument.lookupPrefix(String namespaceURI);

Parameter aufrufen:

  • namespaceURI : String, der den übereinstimmenden Namespace-URI angibt

Gibt das Ergebnis zurück:

  • String , übereinstimmendes Präfix zurückgeben, null zurückgeben, wenn nicht übereinstimmend

lookupNamespaceURI

Gibt den Namespace-URI zurück, der dem angegebenen Präfix auf dem aktuellen Knoten entspricht

1
String XmlDocument.lookupNamespaceURI(String prefix);

Parameter aufrufen:

  • prefix : String, geben Sie das passende Präfix an

Gibt das Ergebnis zurück:

  • String , übereinstimmenden Namespace-URI zurückgeben, null zurückgeben, wenn nicht übereinstimmend

insertBefore

Fügen Sie einen neuen untergeordneten Knoten vor dem vorhandenen untergeordneten Knoten ein

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

Parameter aufrufen:

Gibt das Ergebnis zurück:

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum entfernt und dann wieder an seiner neuen Position eingefügt. Knoten aus einem Dokument (oder aus einem Dokument erstellte Knoten) können nicht in ein anderes Dokument eingefügt werden. Das heißt, die ownerDocument-Eigenschaft von newChild muss mit der ownerDocument-Eigenschaft des aktuellen Knotens identisch sein.


insertAfter

Fügen Sie einen neuen untergeordneten Knoten nach einem vorhandenen untergeordneten Knoten ein

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

Parameter aufrufen:

Gibt das Ergebnis zurück:

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum entfernt und dann wieder an seiner neuen Position eingefügt. Knoten aus einem Dokument (oder aus einem Dokument erstellte Knoten) können nicht in ein anderes Dokument eingefügt werden. Das heißt, die ownerDocument-Eigenschaft von newChild muss mit der ownerDocument-Eigenschaft des aktuellen Knotens identisch sein.


appendChild

Fügen Sie am Ende der Liste der untergeordneten Knoten des Knotens einen neuen untergeordneten Knoten hinzu

1
XmlNode XmlDocument.appendChild(XmlNode newChild);

Parameter aufrufen:

  • newChild : XmlNode , geben Sie den hinzugefügten Knoten an

Gibt das Ergebnis zurück:

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum entfernt und dann wieder an seiner neuen Position eingefügt. Knoten aus einem Dokument (oder aus einem Dokument erstellte Knoten) können nicht in ein anderes Dokument eingefügt werden. Das heißt, die ownerDocument-Eigenschaft von newChild muss mit der ownerDocument-Eigenschaft des aktuellen Knotens identisch sein.


replaceChild

Ersetzen Sie einen untergeordneten Knoten durch einen anderen

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

Parameter aufrufen:

  • newChild : XmlNode , geben Sie einen neuen Knoten an
  • oldChild : XmlNode , geben Sie den zu ersetzenden Knoten an

Gibt das Ergebnis zurück:

  • XmlNode : Wenn die Ersetzung erfolgreich ist, kann diese Methode den ersetzten Knoten zurückgeben. Wenn die Ersetzung fehlschlägt, wird null zurückgegeben

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum entfernt und dann wieder an seiner neuen Position eingefügt. Knoten aus einem Dokument (oder aus einem Dokument erstellte Knoten) können nicht in ein anderes Dokument eingefügt werden. Das heißt, die ownerDocument-Eigenschaft von newChild muss mit der ownerDocument-Eigenschaft des aktuellen Knotens identisch sein.


removeChild

Entfernen Sie einen Knoten aus der Liste der untergeordneten Knoten

1
XmlNode XmlDocument.removeChild(XmlNode oldChild);

Parameter aufrufen:

  • oldChild : XmlNode , geben Sie den zu löschenden Knoten an

Gibt das Ergebnis zurück:

  • XmlNode : Wenn das Löschen erfolgreich ist, kann diese Methode den gelöschten Knoten zurückgeben. Wenn dies fehlschlägt, wird null zurückgegeben

toString

Gibt eine Zeichenfolgendarstellung des Objekts zurück, normalerweise "[Native Object]". Objekte können gemäß ihren eigenen Merkmalen neu implementiert werden

1
String XmlDocument.toString();

Gibt das Ergebnis zurück:

  • String , gibt eine String-Darstellung des Objekts zurück

toJSON

Gibt eine JSON-Darstellung des Objekts zurück, die normalerweise eine Sammlung lesbarer Eigenschaften zurückgibt, die vom Objekt definiert wurden

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

Parameter aufrufen:

  • key : String, unbenutzt

Gibt das Ergebnis zurück:

  • Value , gibt einen Wert zurück, der einen serialisierbaren JSON enthält