.NET Framework Class Library XNode..::.ReplaceWith Method (Object) Replaces this node with the specified content. (in System.Xml.Linq.dll)
Syntax
Public Sub ReplaceWith ( _
content As Object _
)
public void ReplaceWith(
Object content
)
public:
void ReplaceWith(
Object^ content
)
member ReplaceWith :
content:Object -> unit
Remarks
This method first removes this node from its parent, and then adds the specified content to this node's parent, in the place of this node. The XContainer stores its child nodes as a singly-linked list of XNode objects. This means that the ReplaceWith method must traverse the list of direct child nodes under the parent container. Therefore, using this method might affect your performance. For details about the valid content that can be passed to this method, see Valid Content of XElement and XDocument Objects. This method will raise the Changed and the Changing events.
Examples
The following example uses this method to replace the contents of a node with different content.
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)
This example produces the following output:
<Root>
<Child1>child1 content</Child1>
<Child2>child2 content</Child2>
<NewChild>new content</NewChild>
<Child4>child4 content</Child4>
<Child5>child5 content</Child5>
</Root>
Version Information
.NET FrameworkSupported in: 4, 3.5 .NET Framework Client ProfileSupported in: 4, 3.5 SP1
Platforms
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
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
See Also
|
.NET Framework-Klassenbibliothek XNode..::.ReplaceWith-Methode (Object) Ersetzt diesen Knoten durch den angegebenen Inhalt. (in System.Xml.Linq.dll)
Syntax
Public Sub ReplaceWith ( _
content As Object _
)
public void ReplaceWith(
Object content
)
public:
void ReplaceWith(
Object^ content
)
member ReplaceWith :
content:Object -> unit
Hinweise
Diese Methode entfernt zunächst den Knoten aus seinem übergeordneten Element und fügt dann dem übergeordneten Element des Knotens den angegebenen Inhalt hinzu, wobei der Knoten durch diesen Inhalt ersetzt wird. Die XContainer-Klasse speichert ihre untergeordneten Knoten als einfach verknüpfte Liste von XNode-Objekten. Dies bedeutet, dass die ReplaceWith-Methode die Liste der direkt untergeordneten Knoten unter dem übergeordneten Container durchlaufen muss. Daher könnte die Verwendung dieser Methode die Leistung beeinträchtigen. Ausführliche Informationen über den gültigen Inhalt, der an diese Methode ü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.
Beispiele
Im folgenden Beispiel wird diese Methode verwendet, um den Inhalt eines Knotens durch anderen Inhalt 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 folgende Ausgabe:
<Root>
<Child1>child1 content</Child1>
<Child2>child2 content</Child2>
<NewChild>new content</NewChild>
<Child4>child4 content</Child4>
<Child5>child5 content</Child5>
</Root>
Versionsinformationen
.NET FrameworkUnterstützt in: 4, 3.5 .NET Framework Client ProfileUnterstützt in: 4, 3.5 SP1
Plattformen
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
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Siehe auch
ReferenzWeitere Ressourcen
|