XNode.Remove Metoda

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

netstandard.dll, System.Xml.XDocument.dll

Zdroj:

XNode.cs

Odebere tento uzel z nadřazeného objektu.

public:
 void Remove();

public void Remove();

member this.Remove : unit -> unit

Public Sub Remove ()

Výjimky

InvalidOperationException

Nadřazený objekt je null.

Příklady

Následující příklad odebere uzel z nadřazeného objektu.

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)

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

<Root>
  <Child1>child1 content</Child1>
  <Child2>child2 content</Child2>
  <Child4>child4 content</Child4>
  <Child5>child5 content</Child5>
</Root>

Poznámky

Při programování LINQ to XML byste při dotazování na uzly v této sadě neměli manipulovat ani upravovat sadu uzlů. V praxi to znamená, že byste neměli iterovat sadu uzlů a odebírat je. Místo toho byste je měli materializovat do metody List<T>ToList rozšíření. Pak můžete iterovat seznam a odebrat uzly. Další informace najdete v tématu Smíšené deklarativní kódy nebo imperativní chyby kódu (LINQ to XML).

Případně pokud chcete odebrat sadu uzlů, doporučujeme použít metodu Extensions.Remove . Tato metoda zkopíruje uzly do seznamu a pak iteruje seznam, aby se uzly odebraly.

Tato metoda vyvolá Changed události a Changing události.

Ukládá XContainer podřízené uzly jako ingly propojený seznam XNode objektů. To znamená, že Remove metoda musí procházet seznam přímých podřízených uzlů pod nadřazeným kontejnerem. Proto může použití této metody ovlivnit váš výkon.

Viz také

• Přehled LINQ to XML