XContainer.Element(XName) Metoda

Reference

Definice

Obor názvů:: System.Xml.Linq

Sestavení:: System.Xml.XDocument.dll

Sestavení:: System.Xml.Linq.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá první (v pořadí dokumentů) 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);

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 XNamenebo 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 se nepřidá 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 najdete 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 Addatd.) 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 se přidá do stromu XML, který se vytvoří, pokud a pouze pokud prvek existuje ve zdrojovém stromu. Následující příklad ukazuje tento idiom.

Na rozdíl od Elementsmetody osy není tato metoda. Nepoužívá odložené provádění; jednoduše vrátí prvek, který je volána.

Platí pro

Sdílet prostřednictvím