Gültiger Inhalt von 'XElement'-Objekten und 'XDocument'-Objekten
Aktualisiert: November 2007
In diesem Thema werden die gültigen Argumente beschrieben, die an die Konstruktoren und Methoden übergeben werden können, die zum Hinzufügen von Inhalt zu Elementen und Dokumenten verwendet werden.
Gültiger Inhalt
Abfragen ergeben häufig IEnumerable<T> von XElement oder IEnumerable<T> von XAttribute. Auflistungen von XElement-Objekten oder XAttribute-Objekten können an den XElement-Konstruktor übergeben werden. Daher bietet es sich an, die Ergebnisse einer Abfrage als Inhalt an Methoden und Konstruktoren zu übergeben, mit denen XML-Strukturen aufgefüllt werden.
Beim Hinzufügen einfachen Inhalts können dieser Methode verschiedene Typen übergeben werden. Gültige Typen sind:
Typen, die ToString() implementieren.
Typen, die IEnumerable<T> implementieren.
Beim Hinzufügen komplexen Inhalts können dieser Methode verschiedene Typen übergeben werden.
alle Typen, die eine IEnumerable<T> implementieren
Wenn ein Objekt eine IEnumerable<T> implementiert, wird die Auflistung im Objekt aufgezählt, und alle Elemente in der Auflistung werden hinzugefügt. Wenn die Auflistung XNode-Objekte oder XAttribute-Objekte enthält, wird jedes Element in der Auflistung getrennt hinzugefügt. Wenn die Auflistung Text (oder Objekte, die in Text umgewandelt wurden) enthält, wird der Text in der Auflistung verkettet und als einzelner Textknoten hinzugefügt.
Wenn der Inhalt null ist, wird nichts hinzugefügt. Beim Übergeben einer Auflistung können Elemente in der Auflistung den Wert null haben. Ein null-Element in der Auflistung hat keine Auswirkungen auf die Struktur.
Ein hinzugefügtes Attribut muss innerhalb des Elements, in dem es enthalten ist, einen eindeutigen Namen besitzen.
Wenn der neue Inhalt beim Hinzufügen von XNode-Objekten oder XAttribute-Objekten kein übergeordnetes Element besitzt, werden die Objekte einfach an die XML-Struktur angefügt. Wenn der neue Inhalt bereits ein übergeordnetes Element besitzt und Bestandteil einer anderen XML-Struktur ist, wird der neue Inhalt geklont, und der neu geklonte Inhalt wird an die XML-Struktur angefügt.
Gültiger Inhalt für Dokumente
Es ist nicht möglich, einem Dokument Attribute und einfachen Inhalt hinzuzufügen.
Die Anzahl der Szenarios, in denen Sie ein XDocument erstellen müssen, ist sehr begrenzt. Stattdessen können Sie normalerweise Ihre XML-Strukturen mit einem XElement-Stammknoten erstellen. Sofern es keine bestimmte Anforderung für das Erstellen eines Dokuments gibt (z. B., weil Sie Verarbeitungsanweisungen und Kommentare auf der obersten Ebene erstellen oder Dokumenttypen unterstützen müssen), ist es oft bequemer, XElement als Stammknoten zu verwenden.
Als gültiger Inhalt für Dokumente gilt z. B.:
kein oder ein XDocumentType-Objekt: Die Dokumenttypen müssen vor dem Element kommen.
kein oder ein Element
keine oder mehrere Kommentare
keine oder mehrere Verarbeitungsanweisungen
keine oder mehrere Textknoten, die nur Leerraum enthalten
Konstruktoren und Funktionen, die das Hinzufügen von Inhalt erlauben
Die folgenden Methoden ermöglichen es Ihnen, einem XElement oder einem XDocument untergeordneten Inhalt hinzuzufügen:
Methode |
Beschreibung |
|---|---|
Konstruiert ein XElement. |
|
Konstruiert ein XDocument. |
|
Fügt Inhalt am Ende des untergeordneten Inhalts des XElement oder des XDocument hinzu. |
|
Fügt Inhalt nach dem XNode hinzu. |
|
Fügt Inhalt vor dem XNode hinzu. |
|
Fügt Inhalt vor dem untergeordneten Inhalt des XContainer hinzu. |
|
Ersetzt den gesamten Inhalt (untergeordnete Knoten und Attribute) eines XElement. |
|
Ersetzt die Attribute eines XElement. |
|
Ersetzt die untergeordneten Knoten durch neuen Inhalt. |
|
Ersetzt einen Knoten durch neuen Inhalt. |