_CustomXMLPart.AddNode Método

Definição

Namespace:

Microsoft.Office.Core

Assembly:

office.dll

Adiciona um nó a uma árvore XML.

public void AddNode (Microsoft.Office.Core.CustomXMLNode Parent, string Name = "", string NamespaceURI = "", Microsoft.Office.Core.CustomXMLNode NextSibling = default, Microsoft.Office.Core.MsoCustomXMLNodeType NodeType = Microsoft.Office.Core.MsoCustomXMLNodeType.msoCustomXMLNodeElement, string NodeValue = "");

abstract member AddNode : Microsoft.Office.Core.CustomXMLNode * string * string * Microsoft.Office.Core.CustomXMLNode * Microsoft.Office.Core.MsoCustomXMLNodeType * string -> unit

Public Sub AddNode (Parent As CustomXMLNode, Optional Name As String = "", Optional NamespaceURI As String = "", Optional NextSibling As CustomXMLNode = Nothing, Optional NodeType As MsoCustomXMLNodeType = Microsoft.Office.Core.MsoCustomXMLNodeType.msoCustomXMLNodeElement, Optional NodeValue As String = "")

Parâmetros

Parent

CustomXMLNode

Representa no nó ao qual esse nó será adicionado. Ao adicionar um atributo, o parâmetro denota o elemento ao qual o atributo deve ser adicionado.

Name

String

Representa o nome de base do nó a ser adicionado.

NamespaceURI

String

Representa o namespace do elemento a ser anexado. Esse parâmetro é necessário para acrescentar nós do tipo msoCustomXMLNodeElement ou msoCustomXMLNodeAttribute, caso contrário, ele é ignorado.

NextSibling

CustomXMLNode

Representa o nó que deverá se tornar o nó irmão do novo nó. Se não estiver especificado, o nó será adicionado ao final do filho do nó pai. Esse parâmetro é ignorado para adições do tipo msoCustomXMLNodeAttribute. Se o nó não é um filho do pai, um erro será exibido.

NodeType

MsoCustomXMLNodeType

Especifica o tipo de nó a ser anexado. Se o parâmetro não for especificado, presume-se que seja do tipo msoCustomXMLNodeElement.

NodeValue

String

Utilizado para definir o valor do nó anexado para os nós que permitem texto. Se o nó não permitir texto, o parâmetro será ignorado.

Comentários

Se a AddNode(CustomXMLNode, String, String, CustomXMLNode, MsoCustomXMLNodeType, String) operação resultar em uma estrutura de árvore inválida, o acréscimo não será executado e uma mensagem de erro será exibida.