Freigeben über

Übersicht über LINQ to XML-Achsen

Nachdem Sie eine XML-Struktur erstellt oder ein XML-Dokument in eine XML-Struktur geladen haben, können Sie es abfragen, um Elemente und Attribute zu suchen und deren Werte abzurufen. Das Abrufen von Auflistungen erfolgt über die Achsenmethoden, auch kurz Achsen genannt. Einige der Achsen sind Methoden in der XElement-Klasse und in der XDocument-Klasse, die IEnumerable<T>-Auflistungen zurückgeben. Einige der Achsen sind Erweiterungsmethoden in der Extensions Klasse. Die Achsen, die als Erweiterungsmethode implementiert werden, arbeiten mit Auflistungen und geben Auflistungen zurück.

Wie in der XElement-Klassenübersicht beschrieben, stellt ein XElement Objekt einen einzelnen Elementknoten dar. Der Inhalt eines Elements kann komplex (manchmal auch als strukturierter Inhalt bezeichnet) oder ein einfaches Element sein. Ein einfaches Element kann leer sein oder einen Wert enthalten. Wenn der Knoten strukturierte Inhalte enthält, können Sie die verschiedenen Achsenmethoden verwenden, um Enumerationen von untergeordneten Elementen abzurufen. Die am häufigsten verwendeten Achsenmethoden sind Elements und Descendants.

Zusätzlich zu den Achsenmethoden, die Sammlungen zurückgeben, gibt es zwei weitere Methoden, die Sie häufig in LINQ to XML-Abfragen verwenden. Die Element Methode gibt eine einzelne XElementzurück. Die Attribute Methode gibt eine einzelne XAttributezurück.

Linq-Abfragen bieten für viele Zwecke die leistungsfähigste Möglichkeit, eine Struktur zu untersuchen, Daten daraus zu extrahieren und zu transformieren. LINQ-Abfragen arbeiten mit Objekten, die IEnumerable<T> implementieren, und die IEnumerable<T>-Achsen geben XElement von IEnumerable<T>-Sammlungen und von XAttribute-Sammlungen zurück. Sie benötigen diese Auflistungen, um Ihre Abfragen ausführen zu können.

Zusätzlich zu den Achsenmethoden, die Sammlungen von Elementen und Attributen abrufen, gibt es Methoden, mit denen Sie detailliert durch den Baum iterieren können. Anstatt beispielsweise mit Elementen und Attributen zu arbeiten, können Sie mit den Knoten der Struktur arbeiten. Knoten sind eine feinere Granularitätsebene als Elemente und Attribute. Beim Arbeiten mit Knoten können Sie XML-Kommentare, Textknoten, Verarbeitungsanweisungen und vieles mehr untersuchen. Diese Funktionalität ist beispielsweise wichtig für jemanden, der ein Textverarbeitungsprogramm schreibt und Dokumente als XML speichern möchte. Der Großteil der XML-Programmierer befasst sich jedoch hauptsächlich mit Elementen, Attributen und deren Werten.

Methoden zum Abrufen einer Auflistung von Elementen

Die folgende Zusammenfassung beschreibt die Methoden der XElement Klasse (oder deren Basisklassen), die Sie an einem XElement aufrufen, um eine Sammlung von Elementen zurückzugeben.

Methode BESCHREIBUNG
XNode.Ancestors Gibt eine IEnumerable<T> von XElement der Vorgänger dieses Elements zurück. Eine Überladung gibt eine IEnumerable<T> von XElement der Vorgänger mit dem angegebenen XName zurück.
XContainer.Descendants Gibt eine IEnumerable<T> von XElement der Nachfolger dieses Elements zurück. Eine Überladung gibt eine IEnumerable<T> von XElement der Nachfolger mit dem angegebenen XName zurück.
XContainer.Elements Gibt eine IEnumerable<T> von XElement der untergeordneten Elemente dieses Elements zurück. Eine Überladung gibt eine IEnumerable<T> von XElement der untergeordneten Elemente mit dem angegebenen XName zurück.
XNode.ElementsAfterSelf Gibt eine IEnumerable<T> von XElement der Elemente zurück, die diesem Element folgen. Eine Überladung gibt eine IEnumerable<T> von XElement der Elemente mit dem angegebenen XName zurück, die diesem Element folgen.
XNode.ElementsBeforeSelf Gibt eine IEnumerable<T> von XElement der Elemente zurück, die sich vor diesem Element befinden. Eine Überladung gibt eine IEnumerable<T> von XElement der Elemente mit dem angegebenen XName zurück, die sich vor diesem Element befinden.
XElement.AncestorsAndSelf Gibt eine IEnumerable<T> von XElement dieses Elements und dessen Vorgänger zurück. Eine Überladung gibt eine IEnumerable<T> von XElement der Elemente mit dem angegebenen XName zurück.
XElement.DescendantsAndSelf Gibt eine IEnumerable<T> von XElement dieses Elements und dessen Nachfolger zurück. Eine Überladung gibt eine IEnumerable<T> von XElement der Elemente mit dem angegebenen XName zurück.

Methode zum Abrufen eines einzelnen Elements

Die folgende Methode ruft ein einzelnes untergeordnetes Element aus einem XElement-Objekt ab.

Methode BESCHREIBUNG
XContainer.Element Gibt das erste untergeordnete XElement Objekt zurück, das die angegebene XNameEigenschaft aufweist.

Methode zum Abrufen einer Auflistung von Attributen

Die folgende Methode ruft Attribute aus einem XElement Objekt ab.

Methode BESCHREIBUNG
XElement.Attributes Gibt eine IEnumerable<T> von XAttribute aller Attribute zurück.

Methode zum Abrufen eines einzelnen Attributs

Die folgende Methode ruft ein einzelnes Attribut aus einem XElement Objekt ab.

Methode BESCHREIBUNG
XElement.Attribute Gibt das XAttribute zurück, das den angegebenen XName hat.