XContainer.Element(XName) XContainer.Element(XName) XContainer.Element(XName) XContainer.Element(XName) Method

Definition

Ruft das erste (in Dokumentreihenfolge) untergeordnete Element mit dem angegebenen XName ab.Gets the first (in document order) child element with the specified XName.

public:
 System::Xml::Linq::XElement ^ Element(System::Xml::Linq::XName ^ name);
public System.Xml.Linq.XElement Element (System.Xml.Linq.XName name);
member this.Element : System.Xml.Linq.XName -> System.Xml.Linq.XElement
Public Function Element (name As XName) As XElement

Parameter

name
XName XName XName XName

Der XName, mit dem eine Übereinstimmung gefunden werden soll.The XName to match.

Gibt zurück

Ein XElement, das mit dem angegebenen XName übereinstimmt, oder null.A XElement that matches the specified XName, or null.

Beispiele

Das folgende Beispiel zeigt zwei Verwendungen dieser Methode.The following example shows two uses of this method. In einem Fall findet die-Methode das-Element srcTreein.In one case, the method finds the element in srcTree. Im zweiten Fall findet die-Methode das-Element nicht in der Quell Struktur, es wird kein-Element hinzu xmlTreegefügt, und es wird keine Ausnahme ausgelöst.In the second case, the method does not find the element in the source tree, no element is added to xmlTree, and no exception is thrown.

Beachten Sie, dass im Visual Basic Beispiel die untergeordnete XML-Eigenschaft verwendet wird.Note that the Visual Basic example uses the child XML property. Es ist auch zulässig, die Element Methode direkt in Visual Basic zu verwenden.It is also allowable to use the Element method directly in Visual Basic.

XElement srcTree = new XElement("Root",  
    new XElement("Element1", 1),  
    new XElement("Element2", 2),  
    new XElement("Element3", 3),  
    new XElement("Element4", 4),  
    new XElement("Element5", 5)  
);  
XElement xmlTree = new XElement("Root",  
    new XElement("Child1", 1),  
    new XElement("Child2", 2),  
    new XElement("Child3", 3),  
    new XElement("Child4", 4),  
    new XElement("Child5", 5),  
    srcTree.Element("Element3"),  
    // Even though Element9 does not exist in srcTree, the following line  
    // will not throw an exception.  
    srcTree.Element("Element9")  
);  
Console.WriteLine(xmlTree);  
Dim srcTree As XElement = _   
        <Root>  
            <Element1>1</Element1>  
            <Element2>2</Element2>  
            <Element3>3</Element3>  
            <Element4>4</Element4>  
            <Element5>5</Element5>  
        </Root>  

Dim xmlTree As XElement = _  
        <Root>  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
            <Child3>3</Child3>  
            <Child4>4</Child4>  
            <Child5>5</Child5>  
            <%= srcTree.<Element3> %>  
            <%= srcTree.<Element9> %>  
        </Root>  

' Even though Element9 does not exist in srcTree, adding it to the tree  
' will not throw an exception.  

Console.WriteLine(xmlTree)  

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

<Root>  
  <Child1>1</Child1>  
  <Child2>2</Child2>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
  <Element3>3</Element3>  
</Root>  

Im folgenden finden Sie das gleiche Beispiel, aber in diesem Fall befindet sich der XML-Code in einem Namespace.The following is the same example, but in this case the XML is in a namespace. Weitere Informationen finden Sie unter Arbeiten mit XML-Namespaces.For more information, see Working with XML Namespaces.

XNamespace aw = "http://www.adventure-works.com";  
XElement srcTree = new XElement(aw + "Root",  
    new XAttribute(XNamespace.Xmlns + "aw", "http://www.adventure-works.com"),  
    new XElement(aw + "Element1", 1),  
    new XElement(aw + "Element2", 2),  
    new XElement(aw + "Element3", 3),  
    new XElement(aw + "Element4", 4),  
    new XElement(aw + "Element5", 5)  
);  
XElement xmlTree = new XElement(aw + "Root",  
    new XAttribute(XNamespace.Xmlns + "aw", "http://www.adventure-works.com"),  
    new XElement(aw + "Child1", 1),  
    new XElement(aw + "Child2", 2),  
    new XElement(aw + "Child3", 3),  
    new XElement(aw + "Child4", 4),  
    new XElement(aw + "Child5", 5),  
    srcTree.Element(aw + "Element3"),  
    // Even though Element9 does not exist in srcTree, the following line  
    // will not throw an exception.  
    srcTree.Element(aw + "Element9")  
);  
Console.WriteLine(xmlTree);  
Imports <xmlns:aw="http://www.adventure-works.com">  

Module Module1  
    Sub Main()  
        Dim srcTree As XElement = _   
            <aw:Root>  
                <aw:Element1>1</aw:Element1>  
                <aw:Element2>2</aw:Element2>  
                <aw:Element3>3</aw:Element3>  
                <aw:Element4>4</aw:Element4>  
                <aw:Element5>5</aw:Element5>  
            </aw:Root>  

        Dim xmlTree As XElement = _  
            <aw:Root>  
                <aw:Child1>1</aw:Child1>  
                <aw:Child2>2</aw:Child2>  
                <aw:Child3>3</aw:Child3>  
                <aw:Child4>4</aw:Child4>  
                <aw:Child5>5</aw:Child5>  
                <%= srcTree.<aw:Element3> %>  
                <%= srcTree.<aw:Element9> %>  
            </aw:Root>  

        ' Even though Element9 does not exist in srcTree, adding it to the tree  
        ' will not throw an exception.  

        Console.WriteLine(xmlTree)  
    End Sub  
End Module  

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

<aw:Root xmlns:aw="http://www.adventure-works.com">  
  <aw:Child1>1</aw:Child1>  
  <aw:Child2>2</aw:Child2>  
  <aw:Child3>3</aw:Child3>  
  <aw:Child4>4</aw:Child4>  
  <aw:Child5>5</aw:Child5>  
  <aw:Element3>3</aw:Element3>  
</aw:Root>  

Hinweise

Gibt null zurück, wenn kein Element mit dem angegebenen Namen vorhanden ist.Returns null if there is no element with the specified name.

Einige Achsen Methoden geben Auflistungen von Elementen oder Attributen zurück.Some axis methods return collections of elements or attributes. Diese Methode gibt nur ein einzelnes Element zurück.This method returns only a single element.

Diese Methode gibt null zurück, wenn das Element mit dem angegebenen Namen nicht gefunden wurde.This method returns null if the element with the specified name is not found. Alle Methoden, die es Ihnen ermöglichen,-Elemente (Konstruktor von XElement, Addusw.) zu erstellen, akzeptieren null als gültiges Argument.All of the methods that allow you to construct elements (the constructor of XElement, Add, and so on) accept null as a valid argument. Dies ermöglicht Ihnen die Verwendung eines praktischen Ausdrucks: Sie können diese Methode als Teil der funktionalen Konstruktion aufzurufen, und das-Element wird der XML-Struktur hinzugefügt, die erstellt wird, wenn das Element in der Quell Struktur vorhanden ist.This allows you to use a convenient idiom: you can call this method as part of functional construction, and the element is added to the XML tree being constructed if and only if the element exists in the source tree. Das folgende Beispiel zeigt diese Ausdrucksweise.The following example shows this idiom.

Im Gegensatz zu Elementsist diese Methode keine Achsen Methode.In contrast to Elements, this method is not an axis method. Die verzögerte Ausführung wird nicht verwendet. beim Aufruf wird lediglich ein Element zurückgegeben.It does not use deferred execution; it simply returns an element when called.

Gilt für:

Siehe auch