XmlNode.Clone Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt ein Duplikat dieses Knotens.
public:
virtual System::Xml::XmlNode ^ Clone();
public virtual System.Xml.XmlNode Clone();
abstract member Clone : unit -> System.Xml.XmlNode
override this.Clone : unit -> System.Xml.XmlNode
Public Overridable Function Clone () As XmlNode
Gibt zurück
Der geklonte Knoten.
Beispiele
Im folgenden Beispiel wird der Stammknoten des XML-Dokuments geklont.
using System;
using System.IO;
using System.Xml;
public class Sample {
public static void Main() {
XmlDocument doc = new XmlDocument();
doc.LoadXml("<book ISBN='1-861001-57-5'>" +
"<title>Pride And Prejudice</title>" +
"<price>19.95</price>" +
"</book>");
XmlNode root = doc.FirstChild;
//Clone the root node. The cloned node includes
//child nodes. This is similar to calling CloneNode(true).
XmlNode clone = root.Clone();
Console.WriteLine(clone.OuterXml);
}
}
Option Explicit
Option Strict
Imports System.IO
Imports System.Xml
Public Class Sample
Public Shared Sub Main()
Dim doc As New XmlDocument()
doc.LoadXml("<book ISBN='1-861001-57-5'>" & _
"<title>Pride And Prejudice</title>" & _
"<price>19.95</price>" & _
"</book>")
Dim root As XmlNode = doc.FirstChild
'Clone the root node. The cloned node includes
'child nodes. This is similar to calling CloneNode(true).
Dim clone As XmlNode = root.Clone()
Console.WriteLine(clone.OuterXml)
End Sub
End Class
Hinweise
Durch das Klonen einer XmlElement Kopie aller Attribute und deren Werte, einschließlich der vom XML-Prozessor generierten Attribute, die standardmäßige Attribute darstellen. Diese Methode klont den Knoten und die Unterstruktur rekursiv darunter.
Clone entspricht dem Aufrufen CloneNode(true)von .
Die folgende Tabelle beschreibt das spezifische Verhalten für jedes XmlNodeType.
| Xmlnodetype | Klon |
|---|---|
| Attribute | Klont den Attributknoten, einschließlich untergeordneter Knoten. |
| CData | Klont den CData-Knoten, einschließlich des Dateninhalts. |
| Comment | Klont den Kommentarknoten, einschließlich des Textinhalts. |
| Dokument | Klont den Dokumentknoten, einschließlich aller untergeordneten Knoten. |
| DocumentFragment | Klont den Dokumentfragmentknoten, einschließlich aller untergeordneten Knoten. |
| Dokumenttyp | Klont den Dokumenttypknoten. |
| Element | Klont den Elementknoten, seine Attribute und alle untergeordneten Knoten. |
| Objekt | Entitätsknoten können nicht geklont werden. |
| EntityReference | Klont den Entitätsverweisknoten. Der Ersetzungstext ist nicht enthalten. |
| Notation | Notationsknoten können nicht geklont werden. |
| Verarbeitungsanweisung | Klont den Verarbeitungsanweisungsknoten, einschließlich des Ziels und der Daten. |
| Signifikantes Leerzeichen | Klont den signifikanten Leerraumknoten, einschließlich des Datenwerts. |
| Text | Klont den Textknoten, einschließlich seines Datenwerts. |
| Leerzeichen | Klont den Leerraumknoten, einschließlich des Datenwerts. |
| XML-Deklaration | Klont den XmlDeclaration-Knoten, einschließlich des Datenwerts. |
| Alle anderen Knotentypen. | Diese Knotentypen können nicht geklont werden. |
Diese Methode ist eine Microsoft Erweiterung für das Document Object Model (DOM).