XNode.Remove Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Entfernt diesen Knoten aus dem übergeordneten Element.
public:
void Remove();public void Remove();member this.Remove : unit -> unitPublic Sub Remove ()Ausnahmen
Das übergeordnete Element ist null.
Beispiele
Im folgenden Beispiel wird ein Knoten aus dem übergeordneten Element entfernt.
XElement xmlTree = new XElement("Root",
new XElement("Child1", "child1 content"),
new XElement("Child2", "child2 content"),
new XElement("Child3", "child3 content"),
new XElement("Child4", "child4 content"),
new XElement("Child5", "child5 content")
);
XElement child3 = xmlTree.Element("Child3");
child3.Remove();
Console.WriteLine(xmlTree);
Dim xmlTree As XElement = _
<Root>
<Child1>child1 content</Child1>
<Child2>child2 content</Child2>
<Child3>child3 content</Child3>
<Child4>child4 content</Child4>
<Child5>child5 content</Child5>
</Root>
Dim child3 As XElement = xmlTree.<Child3>(0)
child3.Remove()
Console.WriteLine(xmlTree)
Dieses Beispiel erzeugt die folgende Ausgabe:
<Root>
<Child1>child1 content</Child1>
<Child2>child2 content</Child2>
<Child4>child4 content</Child4>
<Child5>child5 content</Child5>
</Root>
Hinweise
Bei der LINQ to XML-Programmierung sollten Sie einen Satz von Knoten nicht bearbeiten oder ändern, während Sie knoten in diesem Satz abfragen. In der Praxis bedeutet dies, dass Sie nicht über eine Reihe von Knoten iterieren und entfernen sollten. Stattdessen sollten Sie sie mithilfe der List<T> Erweiterungsmethode in eine ToList materialisieren. Anschließend können Sie die Liste durchlaufen, um die Knoten zu entfernen. Weitere Informationen finden Sie unter Mixed Declarative Code/Imperative Code Bugs (LINQ to XML).For more information, see Mixed Declarative Code/Imperative Code Bugs (LINQ to XML).
Wenn Sie eine Reihe von Knoten entfernen möchten, empfiehlt es sich, die Extensions.Remove Methode zu verwenden. Diese Methode kopiert die Knoten in eine Liste und durchläuft dann die Liste, um die Knoten zu entfernen.
Diese Methode löst die Changed Ereignisse und ereignisse Changing aus.
Die XContainer untergeordneten Knoten werden als eine miteinander verknüpfte Liste von XNode Objekten gespeichert. Dies bedeutet, dass die Remove Methode die Liste der direkten untergeordneten Knoten unter dem übergeordneten Container durchlaufen muss. Daher kann sich die Verwendung dieser Methode auf Ihre Leistung auswirken.
