XPathNavigator.AppendChildElement(String, String, String, String) 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
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs
Origem:
XPathNavigator.cs

Cria um novo nó de elemento filho no final da lista de nós filhos do nó atual usando o prefixo do espaço de nomes, nome local e URI do espaço de nomes especificados com o valor especificado.

public:
 virtual void AppendChildElement(System::String ^ prefix, System::String ^ localName, System::String ^ namespaceURI, System::String ^ value);
public virtual void AppendChildElement(string? prefix, string localName, string? namespaceURI, string? value);
public virtual void AppendChildElement(string prefix, string localName, string namespaceURI, string value);
abstract member AppendChildElement : string * string * string * string -> unit
override this.AppendChildElement : string * string * string * string -> unit
Public Overridable Sub AppendChildElement (prefix As String, localName As String, namespaceURI As String, value As String)

Parâmetros

prefix
String

O prefixo de namespace do novo nó de elemento filho (se existir).

localName
String

O nome local do novo nó de elemento filho (se existir).

namespaceURI
String

O URI do namespace do novo nó de elemento filho (se existir). Empty e null são equivalentes.

value
String

O valor do novo nó de elemento filho. Se Empty ou null forem ultrapassados, cria-se um elemento vazio.

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 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.AppendChildElement(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix), "100");

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.AppendChildElement(navigator.Prefix, "pages", navigator.LookupNamespace(navigator.Prefix), "100")

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 nó elemento, o nó anexado torna-se o quarto nó filho. Se não existirem nós filhos, então é criado um novo nó filho.

Os valores do prefixo e URI do espaço de nomes podem ser obtidos usando o LookupPrefix método ou o LookupNamespace método. Por exemplo, a seguinte sintaxe acrescenta um elemento filho usando o namespace xmlns:bk=http://www.contoso.com/booksdentro do âmbito :

navigator.AppendChildElement(navigator.Prefix, "pages", LookupNamespaceURI(navigator.Prefix), String.Empty)

Isto cria o novo elemento filho <bk:pages/> .

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

  • Se o prefixo do espaço de nomes especificado for null ou String.Empty, então o prefixo para o URI do espaço de nomes do novo elemento é obtido a partir do espaço de nomes atual no âmbito do espaço. Se não houver prefixo de espaço de nomes atribuído ao URI de espaço de nomes especificado no âmbito atual, então um prefixo de espaço de nomes é automaticamente gerado.

  • O AppendChildElement método é válido apenas quando o XPathNavigator está posicionado no nó raiz ou num nó elemento.

  • O AppendChildElement método não afeta a posição do XPathNavigator.

Aplica-se a