XContainer.Element(XName) Metoda

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

netstandard.dll, System.Xml.XDocument.dll

Zdroj:

XContainer.cs

Získá první (v pořadí dokumentu) podřízený prvek se zadaným 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

Parametry

name

XName

To XName se má shodovat.

Návraty

XElement

A XElement , který odpovídá zadanému XNameparametru , nebo null.

Příklady

Následující příklad ukazuje dvě použití této metody. V jednom případě metoda najde prvek v srcTree. V druhém případě metoda nenajde prvek ve zdrojovém stromu, žádný prvek není přidán do xmlTreea není vyvolán žádná výjimka.

Všimněte si, že Visual Basic příklad používá podřízenou vlastnost XML. Je také možné použít metodu Element přímo v 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)

Tento příklad vytvoří následující výstup:

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

Následující příklad je stejný, ale v tomto případě je XML v oboru názvů. Další informace naleznete v tématu Práce s obory názvů XML.

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

Tento příklad vytvoří následující výstup:

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

Poznámky

Vrátí null , pokud neexistuje žádný prvek se zadaným názvem.

Některé metody osy vracejí kolekce prvků nebo atributů. Tato metoda vrátí pouze jeden prvek.

Tato metoda vrátí null , pokud prvek se zadaným názvem nebyl nalezen. Všechny metody, které umožňují vytvořit elementy (konstruktor XElement, Adda tak dále) přijmout null jako platný argument. To vám umožní použít pohodlný idiom: můžete tuto metodu volat jako součást funkční konstrukce a prvek je přidán do stromu XML, který je vytvořen, pokud a pouze pokud prvek existuje ve zdrojovém stromu. Následující příklad ukazuje tento idiom.

Na rozdíl od Elementstéto metody není metoda osy. Nepoužívá odložené provádění; jednoduše vrátí prvek při zavolání.

Viz také

• Elements
• Přehled LINQ to XML