XPathNavigator.InsertAfter Metodo

Definizione

Spazio dei nomi:: System.Xml.XPath

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Crea un nuovo nodo di pari livello dopo il nodo attualmente selezionato.

Overload

Nome	Descrizione
InsertAfter(XPathNavigator)	Crea un nuovo nodo di pari livello dopo il nodo attualmente selezionato usando i nodi nell'oggetto XPathNavigator specificato.
InsertAfter(XmlReader)	Crea un nuovo nodo di pari livello dopo il nodo attualmente selezionato utilizzando il contenuto XML dell'oggetto XmlReader specificato.
InsertAfter()	Restituisce un XmlWriter oggetto utilizzato per creare un nuovo nodo di pari livello dopo il nodo attualmente selezionato.
InsertAfter(String)	Crea un nuovo nodo di pari livello dopo il nodo attualmente selezionato utilizzando la stringa XML specificata.

InsertAfter(XPathNavigator)

Crea un nuovo nodo di pari livello dopo il nodo attualmente selezionato usando i nodi nell'oggetto XPathNavigator specificato.

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)

Parametri

newSibling: XPathNavigator

Oggetto XPathNavigator posizionato nel nodo da aggiungere come nuovo nodo di pari livello.

Eccezioni

ArgumentNullException

Il parametro dell'oggetto XPathNavigator è null.

InvalidOperationException

La posizione di non consente l'inserimento XPathNavigator di un nuovo nodo di pari livello dopo il nodo corrente.

NotSupportedException

l'oggetto XPathNavigator non supporta la modifica.

Esempio

Nell'esempio seguente viene inserito un nuovo pages elemento dopo l'elemento price figlio del primo book elemento nel contosoBooks.xml file utilizzando il nodo contenuto nell'oggetto XPathNavigator specificato. Lo http://www.contoso.com/books spazio dei nomi viene specificato in modo che il nuovo elemento di pari livello venga inserito utilizzando lo stesso spazio dei nomi del documento XML.

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)

L'esempio accetta il contosoBooks.xml file come input.

<?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>

Commenti

Di seguito sono riportate note importanti da considerare quando si usa il InsertAfter metodo .

Se l'oggetto XmlReader viene posizionato su una sequenza di nodi XML, vengono aggiunti tutti i nodi della sequenza.
Il InsertAfter metodo è valido solo quando l'oggetto XPathNavigator è posizionato su un elemento, testo, istruzione di elaborazione o nodo commento.
Il InsertAfter metodo non influisce sulla posizione dell'oggetto XPathNavigator.

Si applica a

InsertAfter(XmlReader)

Crea un nuovo nodo di pari livello dopo il nodo attualmente selezionato utilizzando il contenuto XML dell'oggetto XmlReader specificato.

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)

Parametri

newSibling: XmlReader

Oggetto XmlReader posizionato sui dati XML per il nuovo nodo di pari livello.

Eccezioni

ArgumentException

L'oggetto XmlReader si trova in uno stato di errore o chiuso.

ArgumentNullException

Il parametro dell'oggetto XmlReader è null.

InvalidOperationException

La posizione di non consente l'inserimento XPathNavigator di un nuovo nodo di pari livello dopo il nodo corrente.

NotSupportedException

l'oggetto XPathNavigator non supporta la modifica.

XmlException

Il contenuto XML del parametro dell'oggetto XmlReader non è ben formato.

Esempio

Nell'esempio seguente viene inserito un nuovo pages elemento dopo l'elemento price figlio del primo book elemento nel contosoBooks.xml file utilizzando l'oggetto XmlReader specificato. Lo http://www.contoso.com/books spazio dei nomi viene specificato in modo che il nuovo elemento di pari livello venga inserito utilizzando lo stesso spazio dei nomi del documento XML.

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)

L'esempio accetta il contosoBooks.xml file come input.

<?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>

Commenti

Di seguito sono riportate note importanti da considerare quando si usa il InsertAfter metodo .

Se l'oggetto XmlReader viene posizionato su una sequenza di nodi XML, vengono aggiunti tutti i nodi della sequenza.
Il InsertAfter metodo è valido solo quando l'oggetto XPathNavigator è posizionato su un elemento, testo, istruzione di elaborazione o nodo commento.
Il InsertAfter metodo non influisce sulla posizione dell'oggetto XPathNavigator.

Si applica a

InsertAfter()

Restituisce un XmlWriter oggetto utilizzato per creare un nuovo nodo di pari livello dopo il nodo attualmente selezionato.

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

Valori restituiti

XmlWriter

Oggetto XmlWriter utilizzato per creare un nuovo nodo di pari livello dopo il nodo attualmente selezionato.

Eccezioni

InvalidOperationException

La posizione di non consente l'inserimento XPathNavigator di un nuovo nodo di pari livello dopo il nodo corrente.

NotSupportedException

l'oggetto XPathNavigator non supporta la modifica.

Esempio

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)

L'esempio accetta il contosoBooks.xml file come input.

<?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>

Commenti

Di seguito sono riportate note importanti da considerare quando si usa il InsertAfter metodo .

Il nuovo nodo di pari livello non viene inserito finché non viene chiamato il Close metodo dell'oggetto XmlWriter .
Il InsertAfter metodo è valido solo quando l'oggetto XPathNavigator è posizionato su un elemento, testo, istruzione di elaborazione o nodo commento.
Il InsertAfter metodo non influisce sulla posizione dell'oggetto XPathNavigator.

Si applica a

InsertAfter(String)

Crea un nuovo nodo di pari livello dopo il nodo attualmente selezionato utilizzando la stringa XML specificata.

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)

Parametri

newSibling: String

Stringa di dati XML per il nuovo nodo di pari livello.

Eccezioni

ArgumentNullException

Il parametro stringa XML è null.

InvalidOperationException

La posizione di non consente l'inserimento XPathNavigator di un nuovo nodo di pari livello dopo il nodo corrente.

NotSupportedException

l'oggetto XPathNavigator non supporta la modifica.

XmlException

Il parametro stringa XML non è ben formato.

Esempio

Nell'esempio seguente viene inserito un nuovo pages elemento dopo l'elemento price figlio del primo book elemento nel contosoBooks.xml file.

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)

L'esempio accetta il contosoBooks.xml file come input.

<?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>

Commenti

Per creare un nuovo nodo elemento, includere tutta la sintassi XML nel parametro stringa XML. La stringa per un nuovo book nodo è InsertAfter("<book/>"). Stringa per l'inserimento del testo "book" dopo il nodo di testo del nodo corrente è InsertAfter("book"). Se la stringa XML contiene più nodi, vengono aggiunti tutti i nodi.

Di seguito sono riportate note importanti da considerare quando si usa il InsertAfter metodo .

Il InsertAfter metodo è valido solo quando l'oggetto XPathNavigator è posizionato su un elemento, testo, istruzione di elaborazione o nodo commento.
Il InsertAfter metodo non influisce sulla posizione dell'oggetto XPathNavigator.

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?