Vorgehensweise: Abrufen eines einzelnen untergeordneten Elements (LINQ to XML) (C#)How to: Retrieve a Single Child Element (LINQ to XML) (C#)

In diesem Thema wird die Vorgehensweise beim Abrufen eines einzelnen untergeordneten Elements nach dessen Namen erläutert.This topic explains how to retrieve a single child element, given the name of the child element. Wenn Sie den Namen des untergeordneten Elements kennen und wissen, dass es nur ein Element mit diesem Namen gibt, ist es möglicherweise sinnvoll, statt einer ganzen Auflistung nur ein einzelnes Element abzurufen.When you know the name of the child element and that there is only one element that has this name, it can be convenient to retrieve just one element, instead of a collection.

Die Element-Methode gibt das erste untergeordnete XElement mit dem angegebenen XName zurück.The Element method returns the first child XElement with the specified XName.

Zum Abrufen eines einzelnen untergeordneten Elements in Visual Basic wird häufig die XML-Eigenschaft verwendet und dann das erste Element mittels der Arrayindexernotation abgerufen.If you want to retrieve a single child element in Visual Basic, a common approach is to use the XML property, and then retrieve the first element using array indexer notation.

BeispielExample

Im folgenden Beispiel wird die Verwendung der Element-Methode gezeigt.The following example demonstrates the use of the Element method. In diesem Beispiel wird die XML-Struktur mit dem Namen po genommen und nach dem ersten Element mit dem Namen Comment gesucht.This example takes the XML tree named po and finds the first element named Comment.

Das Visual Basic-Beispiel zeigt die Verwendung der Arrayindexernotation, um ein einzelnes Element abzurufen.The Visual Basic example shows using array indexer notation to retrieve a single element.

In diesem Beispiel wird das folgende XML-Dokument verwendet: Beispiel-XML-Datei: Typische Bestellung (LINQ to XML).This example uses the following XML document: Sample XML File: Typical Purchase Order (LINQ to XML).

XElement po = XElement.Load("PurchaseOrder.xml");  
XElement e = po.Element("DeliveryNotes");  
Console.WriteLine(e);  

Dieses Beispiel erzeugt die folgende Ausgabe:This example produces the following output:

<DeliveryNotes>Please leave packages in shed by driveway.</DeliveryNotes>  

BeispielExample

Im folgenden Beispiel wird der gleiche Code für XML in einem Namespace gezeigt.The following example shows the same code for XML that is in a namespace. Weitere Informationen finden Sie unter Working with XML Namespaces (C#) (Arbeiten mit XML-Namespaces (C#)).For more information, see Working with XML Namespaces (C#).

In diesem Beispiel wird das folgende XML-Dokument verwendet: Beispiel-XML-Datei: Typische Bestellung in einem Namespace.This example uses the following XML document: Sample XML File: Typical Purchase Order in a Namespace.

XElement po = XElement.Load("PurchaseOrderInNamespace.xml");  
XNamespace aw = "http://www.adventure-works.com";  
XElement e = po.Element(aw + "DeliveryNotes");  
Console.WriteLine(e);  

Dieses Beispiel erzeugt die folgende Ausgabe:This example produces the following output:

<aw:DeliveryNotes xmlns:aw="http://www.adventure-works.com">Please leave packages in shed by driveway.</aw:DeliveryNotes>  

Siehe auchSee Also

LINQ to XML Axes (C#) (LINQ to XML-Achsen (C#))LINQ to XML Axes (C#)