For details about the valid content that can be passed to this function, see Valid Content of XElement and XDocument Objects.

This method will raise the Changed and the Changing events.

This method has snapshot semantics. It first creates a copy of the new content. It then removes all children nodes of this node. Finally, it adds the new content as children nodes. This means that you can replace children nodes using a query on the children nodes themselves.

The following example creates an XML tree that contains children nodes. It then replaces all of the children nodes with a single element.

To see an example of replacing the children nodes with the results of a LINQ query, see 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)

This example produces the following output:

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

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2

Reference

Other Resources

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

Diese Methode löst das Changed-Ereignis und das Changing-Ereignis aus.

Diese Methode verfügt über eine Momentaufnahmensemantik. Sie erstellt zuerst eine Kopie des neuen Inhalts. Dann entfernt sie alle untergeordneten Knoten dieses Knotens. Schließlich fügt sie den neuen Inhalt als untergeordnete Knoten hinzu. Dies bedeutet, dass Sie untergeordnete Knoten mithilfe einer Abfrage der untergeordneten Knoten selbst ersetzen können.

Im folgenden Beispiel wird eine XML-Struktur erstellt, die untergeordnete Knoten enthält. Dann 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)

Mit diesem Beispiel wird die folgende Ausgabe erzeugt:

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

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz

Weitere Ressourcen