XPathNavigator.PrependChild Método

Definição

Espaço de Nomes:
System.Xml.XPath
Assemblagens:
netstandard.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.XPath.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Cria um novo nó filho no início da lista de nós filhos do nó atual.

Sobrecargas

Name Description
PrependChild()

Devolve um XmlWriter objeto usado para criar um novo nó filho no início da lista de nós filhos do nó atual.
PrependChild(String)

Cria um novo nó filho no início da lista de nós filhos do nó atual usando a string XML especificada.
PrependChild(XmlReader)

Cria um novo nó filho no início da lista de nós filhos do nó atual usando o conteúdo XML do XmlReader objeto especificado.
PrependChild(XPathNavigator)

Cria um novo nó filho no início da lista de nós filhos do nó atual usando os nós no XPathNavigator objeto especificado.

PrependChild()

Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs

Devolve um XmlWriter objeto usado para criar um novo nó filho no início da lista de nós filhos do nó atual.

public:
 virtual System::Xml::XmlWriter ^ PrependChild();
public virtual System.Xml.XmlWriter PrependChild();
abstract member PrependChild : unit -> System.Xml.XmlWriter
override this.PrependChild : unit -> System.Xml.XmlWriter
Public Overridable Function PrependChild () As XmlWriter

Devoluções

XmlWriter

Um XmlWriter objeto usado para criar um novo nó filho no início da lista de nós filhos do nó atual.

Exceções

InvalidOperationException

O nó atual onde está XPathNavigator posicionado não permite que um novo nó filho seja preinstalado.

NotSupportedException

Não XPathNavigator suporta edição.

Exemplos

No exemplo seguinte, um novo pages elemento filho é colocado no início da lista de elementos filhos do primeiro book elemento do contosoBooks.xml ficheiro usando o XmlWriter objeto devolvido pelo PrependChild método.

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");

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

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")

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

Console.WriteLine(navigator.OuterXml)

O exemplo usa o contosoBooks.xml arquivo como uma entrada.

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

Observações

Antes de lançar um nó filho adiciona o novo nó ao início da lista de nós filhos do nó atual. Por exemplo, quando existem três nós filhos para um elemento, o nó prependido torna-se o primeiro nó filho. Se não existirem nós filhos, então é criado um novo nó filho.

Seguem-se as notas importantes a considerar ao utilizar o PrependChild método.

Aplica-se a

PrependChild(String)

Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs

Cria um novo nó filho no início da lista de nós filhos do nó atual usando a string XML especificada.

public:
 virtual void PrependChild(System::String ^ newChild);
public virtual void PrependChild(string newChild);
abstract member PrependChild : string -> unit
override this.PrependChild : string -> unit
Public Overridable Sub PrependChild (newChild As String)

Parâmetros

newChild
String

A cadeia de dados XML para o novo nó filho.

Exceções

ArgumentNullException

O parâmetro de string XML é null.

InvalidOperationException

O nó atual onde está XPathNavigator posicionado não permite que um novo nó filho seja preinstalado.

NotSupportedException

Não XPathNavigator suporta edição.

XmlException

O parâmetro de string XML não está bem formado.

Exemplos

No exemplo seguinte, um novo pages elemento filho é colocado no início da lista de elementos filhos do primeiro book elemento do contosoBooks.xml ficheiro.

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.PrependChild("<pages>100</pages>");

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.PrependChild("<pages>100</pages>")

Console.WriteLine(navigator.OuterXml)

O exemplo usa o contosoBooks.xml arquivo como uma entrada.

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

Observações

Antes de lançar um nó filho adiciona o novo nó ao início da lista de nós filhos do nó atual. Por exemplo, quando existem três nós filhos para um elemento, o nó prependido torna-se o primeiro nó filho. Se não existirem nós filhos, então é criado um novo nó filho.

Para criar um novo nó de elemento, inclua toda a sintaxe XML no parâmetro da string XML. A cadeia para um novo book nó é PrependChild("<book/>"). A cadeia para anexar o "livro" de texto ao nó de texto do nó atual é PrependChild("book"). Se a cadeia XML contiver múltiplos nós, todos os nós são adicionados.

Seguem-se as notas importantes a considerar ao utilizar o PrependChild método.

Aplica-se a

PrependChild(XmlReader)

Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs

Cria um novo nó filho no início da lista de nós filhos do nó atual usando o conteúdo XML do XmlReader objeto especificado.

public:
 virtual void PrependChild(System::Xml::XmlReader ^ newChild);
public virtual void PrependChild(System.Xml.XmlReader newChild);
abstract member PrependChild : System.Xml.XmlReader -> unit
override this.PrependChild : System.Xml.XmlReader -> unit
Public Overridable Sub PrependChild (newChild As XmlReader)

Parâmetros

newChild
XmlReader

Um XmlReader objeto posicionado nos dados XML para o novo nó filho.

Exceções

ArgumentException

O XmlReader objeto está num estado de erro ou fechado.

ArgumentNullException

O XmlReader parâmetro do objeto é null.

InvalidOperationException

O nó atual onde está XPathNavigator posicionado não permite que um novo nó filho seja preinstalado.

NotSupportedException

Não XPathNavigator suporta edição.

XmlException

O conteúdo XML do XmlReader parâmetro do objeto não está bem formado.

Exemplos

No exemplo seguinte, um novo pages elemento filho é colocado no início da lista de elementos filhos do primeiro book elemento do contosoBooks.xml ficheiro usando o XmlReader objeto especificado. O http://www.contoso.com/books espaço de nomes é especificado de modo a que o novo elemento filho seja inserido no mesmo espaço de nomes do 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");

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

navigator.PrependChild(pages);

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")

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

navigator.PrependChild(pages)

Console.WriteLine(navigator.OuterXml)

O exemplo usa o contosoBooks.xml arquivo como uma entrada.

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

Observações

Antes de lançar um nó filho adiciona o novo nó ao início da lista de nós filhos do nó atual. Por exemplo, quando existem três nós filhos para um elemento, o nó prependido torna-se o primeiro nó filho. Se não existirem nós filhos, então é criado um novo nó filho.

Seguem-se as notas importantes a considerar ao utilizar o PrependChild método.

Aplica-se a

PrependChild(XPathNavigator)

Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs

Cria um novo nó filho no início da lista de nós filhos do nó atual usando os nós no XPathNavigator objeto especificado.

public:
 virtual void PrependChild(System::Xml::XPath::XPathNavigator ^ newChild);
public virtual void PrependChild(System.Xml.XPath.XPathNavigator newChild);
abstract member PrependChild : System.Xml.XPath.XPathNavigator -> unit
override this.PrependChild : System.Xml.XPath.XPathNavigator -> unit
Public Overridable Sub PrependChild (newChild As XPathNavigator)

Parâmetros

newChild
XPathNavigator

Um XPathNavigator objeto posicionado no nó para ser adicionado como novo nó filho.

Exceções

ArgumentNullException

O XPathNavigator parâmetro do objeto é null.

InvalidOperationException

O nó atual onde está XPathNavigator posicionado não permite que um novo nó filho seja preinstalado.

NotSupportedException

Não XPathNavigator suporta edição.

Exemplos

No exemplo seguinte, um novo pages elemento filho é inserido no início da lista de elementos filhos do primeiro book elemento do contosoBooks.xml ficheiro usando o nó contido no XPathNavigator objeto especificado. O http://www.contoso.com/books espaço de nomes é especificado de modo a que o novo elemento filho seja inserido no mesmo espaço de nomes do 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");

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

navigator.PrependChild(childNodesNavigator);

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")

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.PrependChild(childNodesNavigator)

Console.WriteLine(navigator.OuterXml)

O exemplo usa o contosoBooks.xml arquivo como uma entrada.

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

Observações

Antes de lançar um nó filho adiciona o novo nó ao início da lista de nós filhos do nó atual. Por exemplo, quando existem três nós filhos para um elemento, o nó prependido torna-se o primeiro nó filho. Se não existirem nós filhos, então é criado um novo nó filho.

Seguem-se as notas importantes a considerar ao utilizar o PrependChild método.

Aplica-se a