XPathNavigator.InsertAfter Methode

Definition

Namespace:: System.Xml.XPath

Assemblys:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XPath.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

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 einen neuen gleichgeordneten Knoten nach dem aktuell ausgewählten Knoten.

Überlädt

Name	Beschreibung
InsertAfter(XPathNavigator)	Erstellt einen neuen gleichgeordneten Knoten nach dem aktuell ausgewählten Knoten mithilfe der Knoten im XPathNavigator angegebenen Objekt.
InsertAfter(XmlReader)	Erstellt einen neuen gleichgeordneten Knoten nach dem aktuell ausgewählten Knoten mithilfe des XML-Inhalts des XmlReader angegebenen Objekts.
InsertAfter()	Gibt ein XmlWriter Objekt zurück, das zum Erstellen eines neuen gleichgeordneten Knotens nach dem aktuell ausgewählten Knoten verwendet wird.
InsertAfter(String)	Erstellt einen neuen gleichgeordneten Knoten nach dem aktuell ausgewählten Knoten mithilfe der angegebenen XML-Zeichenfolge.

InsertAfter(XPathNavigator)

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Erstellt einen neuen gleichgeordneten Knoten nach dem aktuell ausgewählten Knoten mithilfe der Knoten im XPathNavigator angegebenen Objekt.

public:
 virtual void InsertAfter(System::Xml::XPath::XPathNavigator ^ newSibling);

public virtual void InsertAfter(System.Xml.XPath.XPathNavigator newSibling);

abstract member InsertAfter : System.Xml.XPath.XPathNavigator -> unit
override this.InsertAfter : System.Xml.XPath.XPathNavigator -> unit

Public Overridable Sub InsertAfter (newSibling As XPathNavigator)

Parameter

newSibling: XPathNavigator

Ein XPathNavigator Objekt, das auf dem Knoten positioniert ist, das als neuer gleichgeordneter Knoten hinzugefügt werden soll.

Ausnahmen

ArgumentNullException

Der XPathNavigator Objektparameter ist null.

InvalidOperationException

Die Position des Knotens XPathNavigator lässt nicht zu, dass nach dem aktuellen Knoten ein neuer gleichgeordneter Knoten eingefügt wird.

NotSupportedException

Die XPathNavigator Bearbeitung wird nicht unterstützt.

Beispiele

Im folgenden Beispiel wird ein neues pages Element nach dem price untergeordneten Element des ersten book Elements in der contosoBooks.xml Datei mithilfe des Knotens eingefügt, der XPathNavigator im angegebenen Objekt enthalten ist. Der http://www.contoso.com/books Namespace wird angegeben, sodass das neue gleichgeordnete Element mit demselben Namespace wie das XML-Dokument eingefügt wird.

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");
navigator.MoveToChild("price", "http://www.contoso.com/books");

XmlDocument childNodes = new XmlDocument();
childNodes.Load(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));
XPathNavigator childNodesNavigator = childNodes.CreateNavigator();

navigator.InsertAfter(childNodesNavigator);

navigator.MoveToParent();
Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")
navigator.MoveToChild("price", "http://www.contoso.com/books")

Dim childNodes As XmlDocument = New XmlDocument()
childNodes.Load(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))
Dim childNodesNavigator As XPathNavigator = childNodes.CreateNavigator()

navigator.InsertAfter(childNodesNavigator)

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

Im Beispiel wird die contosoBooks.xml Datei als Eingabe verwendet.

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://www.contoso.com/books">
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
        <title>The Autobiography of Benjamin Franklin</title>
        <author>
            <first-name>Benjamin</first-name>
            <last-name>Franklin</last-name>
        </author>
        <price>8.99</price>
    </book>
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
        <title>The Confidence Man</title>
        <author>
            <first-name>Herman</first-name>
            <last-name>Melville</last-name>
        </author>
        <price>11.99</price>
    </book>
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
        <title>The Gorgias</title>
        <author>
            <name>Plato</name>
        </author>
        <price>9.99</price>
    </book>
</bookstore>

Hinweise

Im Folgenden finden Sie wichtige Hinweise, die Sie bei der Verwendung der InsertAfter Methode berücksichtigen sollten.

Wenn das XmlReader Objekt über einer Sequenz von XML-Knoten positioniert wird, werden alle Knoten in der Sequenz hinzugefügt.
Die InsertAfter Methode ist nur gültig, wenn die XPathNavigator Position auf einem Element, Text, Verarbeitungsanweisung oder Kommentarknoten erfolgt.
Die InsertAfter Methode wirkt sich nicht auf die Position der XPathNavigator.

Gilt für:

InsertAfter(XmlReader)

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Erstellt einen neuen gleichgeordneten Knoten nach dem aktuell ausgewählten Knoten mithilfe des XML-Inhalts des XmlReader angegebenen Objekts.

public:
 virtual void InsertAfter(System::Xml::XmlReader ^ newSibling);

public virtual void InsertAfter(System.Xml.XmlReader newSibling);

abstract member InsertAfter : System.Xml.XmlReader -> unit
override this.InsertAfter : System.Xml.XmlReader -> unit

Public Overridable Sub InsertAfter (newSibling As XmlReader)

Parameter

newSibling: XmlReader

Ein XmlReader Objekt, das in den XML-Daten für den neuen gleichgeordneten Knoten positioniert ist.

Ausnahmen

ArgumentException

Das XmlReader Objekt befindet sich in einem Fehlerzustand oder geschlossen.

ArgumentNullException

Der XmlReader Objektparameter ist null.

InvalidOperationException

Die Position des Knotens XPathNavigator lässt nicht zu, dass nach dem aktuellen Knoten ein neuer gleichgeordneter Knoten eingefügt wird.

NotSupportedException

Die XPathNavigator Bearbeitung wird nicht unterstützt.

XmlException

Der XML-Inhalt des XmlReader Objektparameters ist nicht wohlgeformt.

Beispiele

Im folgenden Beispiel wird nach dem pages untergeordneten Element des ersten price Elements in der book Datei mithilfe des contosoBooks.xml angegebenen Objekts ein neues XmlReader Element eingefügt. Der http://www.contoso.com/books Namespace wird angegeben, sodass das neue gleichgeordnete Element mit demselben Namespace wie das XML-Dokument eingefügt wird.

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");
navigator.MoveToChild("price", "http://www.contoso.com/books");

XmlReader pages = XmlReader.Create(new StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator.InsertAfter(pages);

navigator.MoveToParent();
Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")
navigator.MoveToChild("price", "http://www.contoso.com/books")

Dim pages As XmlReader = XmlReader.Create(New StringReader("<pages xmlns='http://www.contoso.com/books'>100</pages>"))

navigator.InsertAfter(pages)

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

Im Beispiel wird die contosoBooks.xml Datei als Eingabe verwendet.

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://www.contoso.com/books">
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
        <title>The Autobiography of Benjamin Franklin</title>
        <author>
            <first-name>Benjamin</first-name>
            <last-name>Franklin</last-name>
        </author>
        <price>8.99</price>
    </book>
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
        <title>The Confidence Man</title>
        <author>
            <first-name>Herman</first-name>
            <last-name>Melville</last-name>
        </author>
        <price>11.99</price>
    </book>
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
        <title>The Gorgias</title>
        <author>
            <name>Plato</name>
        </author>
        <price>9.99</price>
    </book>
</bookstore>

Hinweise

Im Folgenden finden Sie wichtige Hinweise, die Sie bei der Verwendung der InsertAfter Methode berücksichtigen sollten.

Wenn das XmlReader Objekt über einer Sequenz von XML-Knoten positioniert wird, werden alle Knoten in der Sequenz hinzugefügt.
Die InsertAfter Methode ist nur gültig, wenn die XPathNavigator Position auf einem Element, Text, Verarbeitungsanweisung oder Kommentarknoten erfolgt.
Die InsertAfter Methode wirkt sich nicht auf die Position der XPathNavigator.

Gilt für:

InsertAfter()

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Gibt ein XmlWriter Objekt zurück, das zum Erstellen eines neuen gleichgeordneten Knotens nach dem aktuell ausgewählten Knoten verwendet wird.

public:
 virtual System::Xml::XmlWriter ^ InsertAfter();

public virtual System.Xml.XmlWriter InsertAfter();

abstract member InsertAfter : unit -> System.Xml.XmlWriter
override this.InsertAfter : unit -> System.Xml.XmlWriter

Public Overridable Function InsertAfter () As XmlWriter

Gibt zurück

XmlWriter

Ein XmlWriter Objekt, das zum Erstellen eines neuen gleichgeordneten Knotens nach dem aktuell ausgewählten Knoten verwendet wird.

Ausnahmen

InvalidOperationException

Die Position des Knotens XPathNavigator lässt nicht zu, dass nach dem aktuellen Knoten ein neuer gleichgeordneter Knoten eingefügt wird.

NotSupportedException

Die XPathNavigator Bearbeitung wird nicht unterstützt.

Beispiele

Im folgenden Beispiel wird ein neues pages Element nach dem price untergeordneten Element des ersten book Elements in der contosoBooks.xml Datei mithilfe des XmlWriter von der InsertAfter Methode zurückgegebenen Objekts eingefügt.

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");
navigator.MoveToChild("price", "http://www.contoso.com/books");

XmlWriter pages = navigator.InsertAfter();
pages.WriteElementString("pages", "100");
pages.Close();

navigator.MoveToParent();
Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")
navigator.MoveToChild("price", "http://www.contoso.com/books")

Dim pages As XmlWriter = navigator.InsertAfter()
pages.WriteElementString("pages", "100")
pages.Close()

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

Im Beispiel wird die contosoBooks.xml Datei als Eingabe verwendet.

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://www.contoso.com/books">
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
        <title>The Autobiography of Benjamin Franklin</title>
        <author>
            <first-name>Benjamin</first-name>
            <last-name>Franklin</last-name>
        </author>
        <price>8.99</price>
    </book>
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
        <title>The Confidence Man</title>
        <author>
            <first-name>Herman</first-name>
            <last-name>Melville</last-name>
        </author>
        <price>11.99</price>
    </book>
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
        <title>The Gorgias</title>
        <author>
            <name>Plato</name>
        </author>
        <price>9.99</price>
    </book>
</bookstore>

Hinweise

Im Folgenden finden Sie wichtige Hinweise, die Sie bei der Verwendung der InsertAfter Methode berücksichtigen sollten.

Der neue gleichgeordnete Knoten wird erst eingefügt, wenn die Close Methode des XmlWriter Objekts aufgerufen wird.
Die InsertAfter Methode ist nur gültig, wenn die XPathNavigator Position auf einem Element, Text, Verarbeitungsanweisung oder Kommentarknoten erfolgt.
Die InsertAfter Methode wirkt sich nicht auf die Position der XPathNavigator.

Gilt für:

InsertAfter(String)

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Quelle:: XPathNavigator.cs

Erstellt einen neuen gleichgeordneten Knoten nach dem aktuell ausgewählten Knoten mithilfe der angegebenen XML-Zeichenfolge.

public:
 virtual void InsertAfter(System::String ^ newSibling);

public virtual void InsertAfter(string newSibling);

abstract member InsertAfter : string -> unit
override this.InsertAfter : string -> unit

Public Overridable Sub InsertAfter (newSibling As String)

Parameter

newSibling: String

Die XML-Datenzeichenfolge für den neuen gleichgeordneten Knoten.

Ausnahmen

ArgumentNullException

Der XML-Zeichenfolgenparameter ist null.

InvalidOperationException

Die Position des Knotens XPathNavigator lässt nicht zu, dass nach dem aktuellen Knoten ein neuer gleichgeordneter Knoten eingefügt wird.

NotSupportedException

Die XPathNavigator Bearbeitung wird nicht unterstützt.

XmlException

Der XML-Zeichenfolgenparameter ist nicht wohlgeformt.

Beispiele

Im folgenden Beispiel wird ein neues pages Element nach dem price untergeordneten Element des ersten book Elements in der contosoBooks.xml Datei eingefügt.

XmlDocument document = new XmlDocument();
document.Load("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

navigator.MoveToChild("bookstore", "http://www.contoso.com/books");
navigator.MoveToChild("book", "http://www.contoso.com/books");
navigator.MoveToChild("price", "http://www.contoso.com/books");

navigator.InsertAfter("<pages>100</pages>");

navigator.MoveToParent();
Console.WriteLine(navigator.OuterXml);

Dim document As XmlDocument = New XmlDocument()
document.Load("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

navigator.MoveToChild("bookstore", "http://www.contoso.com/books")
navigator.MoveToChild("book", "http://www.contoso.com/books")
navigator.MoveToChild("price", "http://www.contoso.com/books")

navigator.InsertAfter("<pages>100</pages>")

navigator.MoveToParent()
Console.WriteLine(navigator.OuterXml)

Im Beispiel wird die contosoBooks.xml Datei als Eingabe verwendet.

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://www.contoso.com/books">
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
        <title>The Autobiography of Benjamin Franklin</title>
        <author>
            <first-name>Benjamin</first-name>
            <last-name>Franklin</last-name>
        </author>
        <price>8.99</price>
    </book>
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
        <title>The Confidence Man</title>
        <author>
            <first-name>Herman</first-name>
            <last-name>Melville</last-name>
        </author>
        <price>11.99</price>
    </book>
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
        <title>The Gorgias</title>
        <author>
            <name>Plato</name>
        </author>
        <price>9.99</price>
    </book>
</bookstore>

Hinweise

Um einen neuen Elementknoten zu erstellen, schließen Sie alle XML-Syntax in den XML-Zeichenfolgenparameter ein. Die Zeichenfolge für einen neuen book Knoten lautet InsertAfter("<book/>"). Die Zeichenfolge zum Einfügen des Texts "Book" nach dem Textknoten des aktuellen Knotens ist InsertAfter("book"). Wenn die XML-Zeichenfolge mehrere Knoten enthält, werden alle Knoten hinzugefügt.

Im Folgenden finden Sie wichtige Hinweise, die Sie bei der Verwendung der InsertAfter Methode berücksichtigen sollten.

Die InsertAfter Methode ist nur gültig, wenn die XPathNavigator Position auf einem Element, Text, Verarbeitungsanweisung oder Kommentarknoten erfolgt.
Die InsertAfter Methode wirkt sich nicht auf die Position der XPathNavigator.

Gilt für:

Feedback

War diese Seite hilfreich?