XContainer.Element(XName) Methode

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

Parameters

Retouren

Een XElement die overeenkomt met de opgegeven XName, of null.

Voorbeelden

In het volgende voorbeeld ziet u twee toepassingen van deze methode. In één geval zoekt de methode het element in srcTree. In het tweede geval vindt de methode het element in de bronstructuur niet, wordt er geen element toegevoegd aan xmlTreeen wordt er geen uitzondering gegenereerd.

In het Visual Basic voorbeeld wordt de onderliggende XML-eigenschap gebruikt. Het is ook toegestaan om de methode Element rechtstreeks in Visual Basic te gebruiken.

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)

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

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

Hier volgt hetzelfde voorbeeld, maar in dit geval bevindt de XML zich in een naamruimte. Zie Werken met XML-naamruimten voor meer informatie.

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

In dit voorbeeld wordt de volgende uitvoer gegenereerd:

<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>

Opmerkingen

Retourneert null als er geen element is met de opgegeven naam.

Sommige asmethoden retourneren verzamelingen elementen of kenmerken. Deze methode retourneert slechts één element.

Deze methode retourneert null als het element met de opgegeven naam niet wordt gevonden. Alle methoden waarmee u elementen (de constructor van XElement, Addenzovoort) kunt maken, accepteren null als een geldig argument. Hiermee kunt u een handige idioom gebruiken: u kunt deze methode aanroepen als onderdeel van functionele constructie en het element wordt toegevoegd aan de XML-structuur die wordt samengesteld als en alleen als het element in de bronstructuur bestaat. In het volgende voorbeeld ziet u dit idioom.

In tegenstelling tot Elements, deze methode is geen asmethode. Er wordt geen uitgestelde uitvoering gebruikt; het retourneert gewoon een element wanneer het wordt aangeroepen.

Zie ook

• Elements
• Overzicht van LINQ naar XML