Compartilhar via


XPathNavigator.PrependChild Método

Definição

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

Sobrecargas

PrependChild()

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

PrependChild(String)

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

PrependChild(XmlReader)

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

PrependChild(XPathNavigator)

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

PrependChild()

Retorna um objeto XmlWriter usado para criar um novo nó filho no início da lista de nós filho 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

Retornos

XmlWriter

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

Exceções

O nó atual no qual o XPathNavigator está posicionado não permite que um novo nó filho seja anexado.

O XPathNavigator não dá suporte à edição.

Exemplos

No exemplo a seguir, um novo pages elemento filho é anexado ao início da lista de elementos filho do primeiro book elemento no contosoBooks.xml arquivo usando o XmlWriter objeto retornado do PrependChild método.

XmlDocument^ document = gcnew 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);
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 arquivo contosoBooks.xml como 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>  

Comentários

A anexação de um nó filho adiciona o novo nó ao início da lista de nós filho para o nó atual. Por exemplo, quando existem três nós filho para um elemento, o nó prefixado se torna o primeiro nó filho. Se nenhum nó filho existir, um novo nó filho será criado.

Veja a seguir notas importantes a serem consideradas ao usar o PrependChild método.

Aplica-se a

PrependChild(String)

Cria um novo nó filho no início da lista de nós filho do nó atual usando a cadeia de caracteres 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 do novo nó filho.

Exceções

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

O nó atual no qual o XPathNavigator está posicionado não permite que um novo nó filho seja anexado.

O XPathNavigator não dá suporte à edição.

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

Exemplos

No exemplo a seguir, um novo pages elemento filho é anexado ao início da lista de elementos filho do primeiro book elemento no contosoBooks.xml arquivo.

XmlDocument^ document = gcnew 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);
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 arquivo contosoBooks.xml como 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>  

Comentários

A anexação de um nó filho adiciona o novo nó ao início da lista de nós filho para o nó atual. Por exemplo, quando existem três nós filho para um elemento, o nó prefixado se torna o primeiro nó filho. Se nenhum nó filho existir, um novo nó filho será criado.

Para criar um novo nó de elemento, inclua toda a sintaxe XML no parâmetro de cadeia de caracteres XML. A cadeia de caracteres para um novo book nó é PrependChild("<book/>"). A cadeia de caracteres para acrescentar o texto "book" ao nó de texto do nó atual é PrependChild("book"). Se a cadeia de caracteres XML contiver vários nós, todos os nós serão adicionados.

Veja a seguir notas importantes a serem consideradas ao usar o PrependChild método.

Aplica-se a

PrependChild(XmlReader)

Cria um novo nó filho no início da lista de nós filho do nó atual usando o conteúdo XML do objeto XmlReader 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 objeto XmlReader posicionado nos dados XML para o novo nó filho.

Exceções

O objeto XmlReader está em um estado de erro ou fechado.

O parâmetro do objeto XmlReader é null.

O nó atual no qual o XPathNavigator está posicionado não permite que um novo nó filho seja anexado.

O XPathNavigator não dá suporte à edição.

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

Exemplos

No exemplo a seguir, um novo pages elemento filho é anexado ao início da lista de elementos filho do primeiro book elemento no contosoBooks.xml arquivo usando o XmlReader objeto especificado. O http://www.contoso.com/books namespace é especificado para que o novo elemento filho seja acrescentado usando o mesmo namespace que o documento XML.

XmlDocument^ document = gcnew 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(gcnew StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));

navigator->PrependChild(pages);

Console::WriteLine(navigator->OuterXml);
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 arquivo contosoBooks.xml como 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>  

Comentários

A anexação de um nó filho adiciona o novo nó ao início da lista de nós filho para o nó atual. Por exemplo, quando existem três nós filho para um elemento, o nó prefixado se torna o primeiro nó filho. Se nenhum nó filho existir, um novo nó filho será criado.

Veja a seguir notas importantes a serem consideradas ao usar o PrependChild método.

Aplica-se a

PrependChild(XPathNavigator)

Cria um novo nó filho no início da lista de nós filho do nó atual usando os nós no objeto XPathNavigator 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 objeto XPathNavigator posicionado no nó a ser adicionado como o novo nó filho.

Exceções

O parâmetro do objeto XPathNavigator é null.

O nó atual no qual o XPathNavigator está posicionado não permite que um novo nó filho seja anexado.

O XPathNavigator não dá suporte à edição.

Exemplos

No exemplo a seguir, um novo pages elemento filho é anexado ao início da lista de elementos filho do primeiro book elemento no contosoBooks.xml arquivo usando o nó contido no XPathNavigator objeto especificado. O http://www.contoso.com/books namespace é especificado para que o novo elemento filho seja acrescentado usando o mesmo namespace que o documento XML.

XmlDocument^ document = gcnew 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 = gcnew XmlDocument();
childNodes->Load(gcnew StringReader("<pages xmlns=\"http://www.contoso.com/books\">100</pages>"));
XPathNavigator^ childNodesNavigator = childNodes->CreateNavigator();

navigator->PrependChild(childNodesNavigator);

Console::WriteLine(navigator->OuterXml);
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 arquivo contosoBooks.xml como 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>  

Comentários

A anexação de um nó filho adiciona o novo nó ao início da lista de nós filho para o nó atual. Por exemplo, quando existem três nós filho para um elemento, o nó prefixado se torna o primeiro nó filho. Se nenhum nó filho existir, um novo nó filho será criado.

Veja a seguir notas importantes a serem consideradas ao usar o PrependChild método.

Aplica-se a