XPathNavigator.AppendChild Método

Definição

Espaço de Nomes:: System.Xml.XPath

Assemblagem:: System.Xml.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Cria um novo nó filho no final da lista de nós filhos do nó atual.

Sobrecargas

Name	Description
AppendChild()	Devolve um XmlWriter objeto usado para criar um ou mais novos nós filhos no final da lista de nós filhos do nó atual.
AppendChild(String)	Cria um novo nó filho no final da lista de nós filhos do nó atual usando a cadeia de dados XML especificada.
AppendChild(XmlReader)	Cria um novo nó filho no final da lista de nós filhos do nó atual usando o conteúdo XML do XmlReader objeto especificado.
AppendChild(XPathNavigator)	Cria um novo nó filho no final da lista de nós filhos do nó atual usando os nós especificados XPathNavigator .

AppendChild()

Devolve um XmlWriter objeto usado para criar um ou mais novos nós filhos no final da lista de nós filhos do nó atual.

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

public virtual System.Xml.XmlWriter AppendChild();

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

Public Overridable Function AppendChild () As XmlWriter

Devoluções

XmlWriter

Um XmlWriter objeto usado para criar novos nós filhos no final da lista de nós filhos do nó atual.

Exceções

InvalidOperationException

O nó atual onde está XPathNavigator posicionado não é o nó raiz nem um nó elemental.

NotSupportedException

Não XPathNavigator suporta edição.

Exemplos

No exemplo seguinte, um novo pages elemento filho é adicionado à lista de elementos filhos do primeiro book elemento do contosoBooks.xml ficheiro usando o XmlWriter objeto devolvido pelo AppendChild 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.AppendChild();
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.AppendChild()
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

Adicionar nós filhos adiciona os novos nós ao final da lista de nós filhos do nó atual. Por exemplo, quando existem três nós filhos para um elemento, o primeiro nó acrescentado torna-se o quarto 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 AppendChild método.

O novo nó filho não é inserido até que o Close método do XmlWriter objeto seja chamado.
O AppendChild método é válido apenas quando o XPathNavigator está posicionado no nó raiz ou num nó elemento.
O AppendChild método não afeta a posição do XPathNavigator.

Podes escrever mais do que um nó para o escritor. Todos os nós são acrescentados ao final da lista de nós filhos do nó atual.

Aplica-se a

AppendChild(String)

Cria um novo nó filho no final da lista de nós filhos do nó atual usando a cadeia de dados XML especificada.

public:
 virtual void AppendChild(System::String ^ newChild);

public virtual void AppendChild(string newChild);

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

Public Overridable Sub AppendChild (newChild As String)

Parâmetros

newChild: String

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

Exceções

ArgumentNullException

O parâmetro da cadeia de dados XML é null.

InvalidOperationException

O nó atual onde está XPathNavigator posicionado não é o nó raiz nem um nó elemental.

NotSupportedException

Não XPathNavigator suporta edição.

XmlException

O parâmetro da cadeia de dados XML não está bem formado.

Exemplos

No exemplo a seguir, um novo elemento filho pages é anexado à lista de elementos filho do primeiro elemento book no ficheiro contosoBooks.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.AppendChild("<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.AppendChild("<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

Adicionar um nó filho adiciona o novo nó ao final da lista de nós filhos do nó atual. Por exemplo, quando existem três nós filhos para um elemento, o nó anexado torna-se o quarto 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ó é AppendChild("<book/>"). A cadeia para anexar o "livro" de texto ao nó de texto do nó atual é AppendChild("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 AppendChild método.

O AppendChild método é válido apenas quando o XPathNavigator está posicionado no nó raiz ou num nó elemento.
O AppendChild método não afeta a posição do XPathNavigator.

Aplica-se a

AppendChild(XmlReader)

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

public:
 virtual void AppendChild(System::Xml::XmlReader ^ newChild);

public virtual void AppendChild(System.Xml.XmlReader newChild);

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

Public Overridable Sub AppendChild (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 é o nó raiz nem um nó elemental.

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 é adicionado à 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 adicionado usando o 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.AppendChild(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.AppendChild(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

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

Se o XmlReader objeto estiver posicionado sobre uma sequência de nós XML, todos os nós da sequência são adicionados.
O AppendChild método é válido apenas quando o XPathNavigator está posicionado no nó raiz ou num nó elemento.
O AppendChild método não afeta a posição do XPathNavigator.

Aplica-se a

AppendChild(XPathNavigator)

Cria um novo nó filho no final da lista de nós filhos do nó atual usando os nós especificados XPathNavigator .

public:
 virtual void AppendChild(System::Xml::XPath::XPathNavigator ^ newChild);

public virtual void AppendChild(System.Xml.XPath.XPathNavigator newChild);

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

Public Overridable Sub AppendChild (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 é o nó raiz nem um nó elemental.

NotSupportedException

Não XPathNavigator suporta edição.

Exemplos

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

if(childNodesNavigator.MoveToChild("pages", "http://www.contoso.com/books"))
{
    navigator.AppendChild(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()

If childNodesNavigator.MoveToChild("pages", "http://www.contoso.com/books") Then
    navigator.AppendChild(childNodesNavigator)
End If

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

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

Se o XPathNavigator objeto estiver posicionado sobre uma sequência de nós XML, todos os nós da sequência são adicionados.
O AppendChild método é válido apenas quando o XPathNavigator está posicionado no nó raiz ou num nó elemento.
O AppendChild método não afeta a posição do XPathNavigator.

Aplica-se a

Comentários

Esta página foi útil?