XNode.ReplaceWith Methode

Definition

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Ersetzt diesen Knoten durch den angegebenen Inhalt.

Überlädt

ReplaceWith(Object)	Ersetzt diesen Knoten durch den angegebenen Inhalt.
ReplaceWith(Object[])	Ersetzt diesen Knoten durch den angegebenen Inhalt.

Beispiele

Im folgenden Beispiel wird diese Methode verwendet, um den Inhalt eines Knotens durch andere Inhalte zu ersetzen.

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.ReplaceWith(  
    new XElement("NewChild", "new content")  
);  
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.ReplaceWith(<NewChild>new content</NewChild>)  
Console.WriteLine(xmlTree)  

Dieses Beispiel erzeugt die folgende Ausgabe:

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

Hinweise

Ausführliche Informationen zu den gültigen Inhalten, die an diese Methode übergeben werden können, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

Diese Methode löst die Changed Ereignisse und aus Changing .

Die XContainer untergeordneten Knoten werden als eine singlich verknüpfte Liste von XNode Objekten gespeichert. Dies bedeutet, dass die ReplaceWith -Methode die Liste der direkten untergeordneten Knoten unter dem übergeordneten Container durchlaufen muss. Daher kann sich die Verwendung dieser Methode auf Ihre Leistung auswirken.

ReplaceWith(Object)

Quelle:

XNode.cs

Ersetzt diesen Knoten durch den angegebenen Inhalt.

public:
 void ReplaceWith(System::Object ^ content);

public void ReplaceWith (object? content);

member this.ReplaceWith : obj -> unit

Public Sub ReplaceWith (content As Object)

Parameter

content

Object

Inhalt, durch den dieser Knoten ersetzt wird.

Beispiele

Im folgenden Beispiel wird diese Methode verwendet, um den Inhalt eines Knotens durch andere Inhalte zu ersetzen.

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.ReplaceWith(  
    new XElement("NewChild", "new content")  
);  
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.ReplaceWith(<NewChild>new content</NewChild>)  
Console.WriteLine(xmlTree)  

Dieses Beispiel erzeugt die folgende Ausgabe:

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

Hinweise

Diese Methode entfernt zuerst diesen Knoten aus dem übergeordneten Knoten und fügt dann den angegebenen Inhalt dem übergeordneten Knoten an der Stelle dieses Knotens hinzu.

Die XContainer untergeordneten Knoten werden als eine singlich verknüpfte Liste von XNode Objekten gespeichert. Dies bedeutet, dass die ReplaceWith -Methode die Liste der direkten untergeordneten Knoten unter dem übergeordneten Container durchlaufen muss. Daher kann sich die Verwendung dieser Methode auf Ihre Leistung auswirken.

Ausführliche Informationen zu den gültigen Inhalten, die an diese Methode übergeben werden können, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

Diese Methode löst die Changed Ereignisse und aus Changing .

Weitere Informationen

• Übersicht über LINQ to XML

ReplaceWith(Object[])

Quelle:

XNode.cs

Ersetzt diesen Knoten durch den angegebenen Inhalt.

public:
 void ReplaceWith(... cli::array <System::Object ^> ^ content);

public void ReplaceWith (params object?[] content);

member this.ReplaceWith : obj[] -> unit

Public Sub ReplaceWith (ParamArray content As Object())

Parameter

content

Object[]

Eine Parameterliste des neuen Inhalts.

Beispiele

Das folgende Beispiel zeigt die Verwendung der Ergebnisse einer LINQ to XML Abfrage als Eingabe für diese Methode.

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)  
);  
XElement child3 = xmlTree.Element("Child3");  
child3.ReplaceWith(  
    from el in srcTree.Elements()  
    where (int)el > 3  
    select el  
);  
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>  
        </Root>  

Dim child3 As XElement = xmlTree.<Child3>(0)  
child3.ReplaceWith( _  
    From el In srcTree.Elements() _  
    Where (CInt(el) > 3) _  
    Select el)  

Console.WriteLine(xmlTree)  

Dieses Beispiel erzeugt die folgende Ausgabe:

<Root>  
  <Child1>1</Child1>  
  <Child2>2</Child2>  
  <Element4>4</Element4>  
  <Element5>5</Element5>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>  

Hinweise

Diese Methode entfernt zuerst diesen Knoten aus dem übergeordneten Knoten und fügt dann den angegebenen Inhalt dem übergeordneten Knoten an der Stelle dieses Knotens hinzu.

Die XContainer untergeordneten Knoten werden als eine singlich verknüpfte Liste von XNode Objekten gespeichert. Dies bedeutet, dass die ReplaceWith -Methode die Liste der direkten untergeordneten Knoten unter dem übergeordneten Container durchlaufen muss. Daher kann sich die Verwendung dieser Methode auf Ihre Leistung auswirken.

Ausführliche Informationen zu den gültigen Inhalten, die an diese Methode übergeben werden können, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

Diese Methode löst die Changed Ereignisse und aus Changing .

Weitere Informationen

• Übersicht über LINQ to XML