XContainer.Element-Methode

Gibt null zurück, 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 null zurück, wenn das Element mit dem angegebenen Namen nicht gefunden wurde. Alle Methoden, mit denen Sie Elemente erstellen können (der Konstruktor Add von XElement usw.), akzeptieren null als gültiges Argument. Dies ermöglicht Ihnen die Verwendung einer einfachen Ausdrucksweise: Sie können diese Methode als Teil der funktionalen Erstellung aufrufen, und das Element wird der zu erstellenden XML-Struktur nur dann hinzugefügt, wenn das Element in der Quellstruktur vorhanden ist. Diese Ausdrucksweise wird im folgenden Beispiel veranschaulicht.

Im Gegensatz zu Elements ist diese Methode keine Achsenmethode. Sie verwendet keine verzögerte Ausführung. Bei ihrem Aufruf wird einfach ein Element zurückgegeben.

Im folgenden Beispiel werden zwei Verwendungsmöglichkeiten dieser Methode veranschaulicht. Im ersten Fall findet die Methode das Element in srcTree. Im zweiten Fall findet die Methode das Element nicht in der Quellstruktur, xmlTree wird kein Element hinzugefügt, und es wird keine Ausnahme ausgelöst.

Beachten Sie, dass im Visual Basic-Beispiel die Child-XML-Eigenschaft verwendet wird. Es ist auch zulässig, die Element-Methode 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);

Mit diesem Beispiel wird die folgende Ausgabe erzeugt:

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

Das folgende Beispiel entspricht dem vorherigen Beispiel, jedoch befindet sich in diesem Fall das XML 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);

Mit diesem Beispiel wird die folgende Ausgabe erzeugt:

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

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz

Weitere Ressourcen