XContainer.ReplaceNodes Methode

Definition

Ersetzt die untergeordneten Knoten dieses Dokuments oder Elements durch den angegebenen Inhalt.

Überlädt

ReplaceNodes(Object)

Ersetzt die untergeordneten Knoten dieses Dokuments oder Elements durch den angegebenen Inhalt.

ReplaceNodes(Object[])

Ersetzt die untergeordneten Knoten dieses Dokuments oder Elements durch den angegebenen Inhalt.

Beispiele

Im folgenden Beispiel werden zwei XML-Strukturen erstellt, und dann wird diese Methode verwendet, um den Inhalt einer dieser Strukturen durch die Ergebnisse einer Abfrage zu ersetzen.

XElement root = new XElement("Root",  
    new XElement("Child", 1),  
    new XElement("Child", 2),  
    new XElement("Child", 3),  
    new XElement("Child", 4),  
    new XElement("Child", 5)  
);  
root.ReplaceNodes(  
    from el in root.Elements()  
    where (int)el >= 3  
    select el  
);  
Console.WriteLine(root);  
Dim root As XElement = _   
    <Root>  
        <Child>1</Child>  
        <Child>2</Child>  
        <Child>3</Child>  
        <Child>4</Child>  
        <Child>5</Child>  
    </Root>  
root.ReplaceNodes( _  
    From el In root.Elements _  
    Where el.Value >= 3 _  
    Select el)  
Console.WriteLine(root)  

Dieses Beispiel erzeugt die folgende Ausgabe:

<Root>  
  <Child>3</Child>  
  <Child>4</Child>  
  <Child>5</Child>  
</Root>  

Hinweise

Ausführliche Informationen zum gültigen Inhalt, der an diese Funktion übergeben werden kann, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

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

Diese Methode verfügt über Momentaufnahme Semantik. Zuerst wird eine Kopie des neuen Inhalts erstellt. Anschließend werden alle untergeordneten Knoten dieses Knotens entfernt. Schließlich werden die neuen Inhalte als untergeordnete Knoten hinzugefügt. Dies bedeutet, dass Sie untergeordnete Knoten mithilfe einer Abfrage auf den untergeordneten Knoten selbst ersetzen können.

ReplaceNodes(Object)

Ersetzt die untergeordneten Knoten dieses Dokuments oder Elements durch den angegebenen Inhalt.

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

Parameter

content
Object

Ein Inhaltsobjekt, das einfache Inhalte oder eine Auflistung von Inhaltsobjekten enthält, die die untergeordneten Knoten ersetzen.

Beispiele

Im folgenden Beispiel wird eine XML-Struktur erstellt, die untergeordnete Knoten enthält. Anschließend werden alle untergeordneten Knoten durch ein einzelnes Element ersetzt.

Ein Beispiel für das Ersetzen der untergeordneten Knoten durch die Ergebnisse einer LINQ-Abfrage finden Sie unter ReplaceNodes.

XElement root = new XElement("Root",  
    new XElement("Child", 1),  
    new XElement("Child", 2),  
    new XElement("Child", 3),  
    new XElement("Child", 4),  
    new XElement("Child", 5)  
);  
root.ReplaceNodes(  
    from el in root.Elements()  
    where (int)el >= 3  
    select el  
);  
Console.WriteLine(root);  
Dim root As XElement = _   
    <Root>  
        <Child>1</Child>  
        <Child>2</Child>  
        <Child>3</Child>  
        <Child>4</Child>  
        <Child>5</Child>  
    </Root>  
root.ReplaceNodes( _  
    From el In root.Elements _  
    Where el.Value >= 3 _  
    Select el)  
Console.WriteLine(root)  

Dieses Beispiel erzeugt die folgende Ausgabe:

<Root>  
  <Child>3</Child>  
  <Child>4</Child>  
  <Child>5</Child>  
</Root>  

Hinweise

Ausführliche Informationen zum gültigen Inhalt, der an diese Funktion übergeben werden kann, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

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

Diese Methode verfügt über Momentaufnahme Semantik. Zuerst wird eine Kopie des neuen Inhalts erstellt. Anschließend werden alle untergeordneten Knoten dieses Knotens entfernt. Schließlich werden die neuen Inhalte als untergeordnete Knoten hinzugefügt. Dies bedeutet, dass Sie untergeordnete Knoten mithilfe einer Abfrage auf den untergeordneten Knoten selbst ersetzen können.

Weitere Informationen

Gilt für:

ReplaceNodes(Object[])

Ersetzt die untergeordneten Knoten dieses Dokuments oder Elements durch den angegebenen Inhalt.

public:
 void ReplaceNodes(... cli::array <System::Object ^> ^ content);
public void ReplaceNodes (params object[] content);
public void ReplaceNodes (params object?[] content);
member this.ReplaceNodes : obj[] -> unit
Public Sub ReplaceNodes (ParamArray content As Object())

Parameter

content
Object[]

Eine Parameterliste von Inhaltsobjekten.

Beispiele

Im folgenden Beispiel werden ein Wörterbuch und eine XML-Struktur erstellt. Anschließend fragt er das Wörterbuch ab, projiziert die Ergebnisse in eine IEnumerable<T> von XElementund ersetzt den Inhalt der XML-Struktur durch die Ergebnisse der Abfrage.

XElement root = new XElement("Root",  
    new XElement("Child", 1),  
    new XElement("Child", 2),  
    new XElement("Child", 3),  
    new XElement("Child", 4),  
    new XElement("Child", 5)  
);  
root.ReplaceNodes(  
    from el in root.Elements()  
    where (int)el >= 3  
    select el  
);  
Console.WriteLine(root);  
Dim root As XElement = _   
    <Root>  
        <Child>1</Child>  
        <Child>2</Child>  
        <Child>3</Child>  
        <Child>4</Child>  
        <Child>5</Child>  
    </Root>  
root.ReplaceNodes( _  
    From el In root.Elements _  
    Where el.Value >= 3 _  
    Select el)  
Console.WriteLine(root)  

Dieses Beispiel erzeugt die folgende Ausgabe:

<Root>  
  <Child>3</Child>  
  <Child>4</Child>  
  <Child>5</Child>  
</Root>  

Hinweise

Ausführliche Informationen zum gültigen Inhalt, der an diese Funktion übergeben werden kann, finden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

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

Diese Methode verfügt über Momentaufnahme Semantik. Zuerst wird eine Kopie des neuen Inhalts erstellt. Anschließend werden alle untergeordneten Knoten dieses Knotens entfernt. Schließlich werden die neuen Inhalte als untergeordnete Knoten hinzugefügt. Dies bedeutet, dass Sie untergeordnete Knoten mithilfe einer Abfrage auf den untergeordneten Knoten selbst ersetzen können.

Weitere Informationen

Gilt für: