XNode.ReplaceWith Methode

Definition

Ersetzt diesen Knoten durch den angegebenen Inhalt.

Überlädt

Name Beschreibung
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 "Valid Content of XElement" und "XDocument Objects".

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 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
Quelle:
XNode.cs
Quelle:
XNode.cs
Quelle:
XNode.cs
Quelle:
XNode.cs

Ersetzt diesen Knoten durch den angegebenen Inhalt.

public:
 void ReplaceWith(System::Object ^ content);
public void ReplaceWith(object content);
public void ReplaceWith(object? content);
member this.ReplaceWith : obj -> unit
Public Sub ReplaceWith (content As Object)

Parameter

content
Object

Inhalt, der diesen Knoten ersetzt.

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 diesen Knoten zuerst aus dem übergeordneten Element und fügt dann den angegebenen Inhalt an der Stelle dieses Knotens hinzu.

Die XContainer untergeordneten Knoten werden als eine miteinander 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 "Valid Content of XElement" und "XDocument Objects".

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

Weitere Informationen

Gilt für:

ReplaceWith(Object[])

Quelle:
XNode.cs
Quelle:
XNode.cs
Quelle:
XNode.cs
Quelle:
XNode.cs
Quelle:
XNode.cs

Ersetzt diesen Knoten durch den angegebenen Inhalt.

public:
 void ReplaceWith(... cli::array <System::Object ^> ^ content);
public void ReplaceWith(params 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 diesen Knoten zuerst aus dem übergeordneten Element und fügt dann den angegebenen Inhalt an der Stelle dieses Knotens hinzu.

Die XContainer untergeordneten Knoten werden als eine miteinander 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 "Valid Content of XElement" und "XDocument Objects".

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

Weitere Informationen

Gilt für: