XContainer.Element(XName) Metod

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

Parametrar

Returer

En XElement som matchar den angivna XName, eller null.

Exempel

I följande exempel visas två användningsområden för den här metoden. I ett fall hittar metoden elementet i srcTree. I det andra fallet hittar metoden inte elementet i källträdet, inget element läggs till xmlTreei och inget undantag genereras.

Observera att det Visual Basic exemplet använder den underordnade XML-egenskapen. Det går också att använda metoden Element direkt i 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)

Det här exemplet genererar följande utdata:

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

Följande är samma exempel, men i det här fallet finns XML i ett namnområde. Mer information finns i Arbeta med XML-namnområden.

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

Det här exemplet genererar följande utdata:

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

Kommentarer

Returnerar null om det inte finns något element med det angivna namnet.

Vissa axelmetoder returnerar samlingar av element eller attribut. Den här metoden returnerar bara ett enda element.

Den här metoden returnerar null om elementet med det angivna namnet inte hittas. Alla metoder som gör att du kan konstruera element (konstruktorn för XElement, Addoch så vidare) accepterar null som ett giltigt argument. På så sätt kan du använda ett praktiskt formspråk: du kan anropa den här metoden som en del av funktionell konstruktion och elementet läggs till i XML-trädet som skapas om och endast om elementet finns i källträdet. I följande exempel visas det här formspråket.

Till skillnad från Elementsär den här metoden inte en axelmetod. Den använder inte uppskjuten körning. det returnerar helt enkelt ett element när det anropas.

Se även

• Elements
• Översikt över LINQ till XML