XContainer.Element(XName) Methode

Definition

Namespace:
System.Xml.Linq
Assemblys:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Assemblys:
netstandard.dll, System.Xml.XDocument.dll
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.dll
Quelle:
XContainer.cs
Quelle:
XContainer.cs
Quelle:
XContainer.cs
Quelle:
XContainer.cs
Quelle:
XContainer.cs

Ruft das erste untergeordnete Element (in Dokumentreihenfolge) mit dem angegebenen ab XName.

public:
 System::Xml::Linq::XElement ^ Element(System::Xml::Linq::XName ^ name);
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

Die XName Übereinstimmung.

Gibt zurück

XElement

Eine XElement , die mit dem angegebenen XName, oder null.

Beispiele

Das folgende Beispiel zeigt zwei Verwendungen dieser Methode. In einem Fall findet die Methode das Element in srcTree. Im zweiten Fall findet die Methode das Element in der Quellstruktur nicht, kein Element wird hinzugefügt xmlTree, und es wird keine Ausnahme ausgelöst.

Beachten Sie, dass das Visual Basic Beispiel die untergeordnete XML-Eigenschaft verwendet. Es ist auch zulässig, die methode Element direkt in Visual Basic zu verwenden.

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:

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

Nachfolgend sehen Sie das gleiche Beispiel, aber in diesem Fall befindet sich der XML-Code in einem Namespace. Weitere Informationen finden Sie unter Arbeiten mit 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:

<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 zurück null , wenn kein Element mit dem angegebenen Namen vorhanden ist.

Einige Achsenmethoden geben Auflistungen von Elementen oder Attributen zurück. Diese Methode gibt nur ein einzelnes Element zurück.

Diese Methode gibt zurück null , wenn das Element mit dem angegebenen Namen nicht gefunden wird. Alle Methoden, mit denen Sie Elemente (den Konstruktor von XElement, Addusw.) erstellen können, werden als gültiges Argument akzeptiert null . Auf diese Weise können Sie einen praktischen Idiom verwenden: Sie können diese Methode als Teil der funktionalen Konstruktion aufrufen, und das Element wird der XML-Struktur hinzugefügt, die erstellt wird, wenn und nur, wenn das Element in der Quellstruktur vorhanden ist. Das folgende Beispiel zeigt diesen Idiom.

Im Gegensatz zu Elementsdieser Methode ist diese Methode keine Achsenmethode. Sie verwendet keine verzögerte Ausführung; es gibt einfach ein Element zurück, wenn sie aufgerufen wird.

Gilt für:

Weitere Informationen