createNode Method

9/8/2008

Cria um nó usando o tipo fornecido, Nome e espaço para nome.

Sintaxe de script

var objXMLDOMNode = oXMLDOMDocument.createNode(Type, name, namespaceURI);

Comentários

Parâmetros de script

• Tipo
  Variant. Valor que identifica exclusivamente o tipo de nó. Isso pode ser especificado usando a valor inteiro ou a valor da seqüência de caracteres. Para o lista completa de valores, consulte Constantes Enumeradas DOM XML ou a descrição para o parâmetro nome.

• Nome
  Seqüência de caracteres que contém o valor do nó de novo NodeName propriedade. O relacionamento entre o nó Nome e tipo de nó é resumido abaixo.

• namespaceURI
  Seqüência de caracteres definindo o espaço para nome URI (Uniform Resource Identifier) (URI). Se especificado, o nó é criado no contexto das namespaceURI Com o prefixo especificado no nome de nó. Se o parâmetro nome não tem um prefixo, isso é tratado como o espaço para nome usar como padrão.

Valor Return script

Objeto. Retorna o nó recém-criado.

C/sintaxe C++

HRESULT createNode(
  VARIANT Type,
  BSTR name,
  BSTR namespaceURI,
  IXMLDOMNode** node
);

Comentários

C/parâmetros C++

• Tipo
  [no] Valor que identifica exclusivamente o tipo de nó. Isso pode ser especificado usando a valor inteiro ou a valor da seqüência de caracteres. Para o lista completa de valores, consulte o Constantes Enumeradas DOM XML ou a descrição fornecido para o Nome parâmetro.

• Nome
  [no] Valor do nó de novo NodeName propriedade. O relacionamento entre o nó Nome e tipo de nó é resumido na tabela a seguir.

• namespaceURI
  [no] Namespace URI. Se especificado, o nó é criado no contexto das namespaceURI parâmetro com o prefixo especificado no nome de nó. Se a pasta Nome parâmetro não possui um prefixo, isso é tratado como o espaço para nome usar como padrão.

• nó
  [out, retval] Nó recém-criado.

C/valores Return C++

• S_OK
  Valor retornado se bem-sucedido.

• E_INVALIDARG
  Valor retornado se nó é nulo.

• E_FAIL
  Valor retornado se ocorrerá um erro.

Requisitos

Header	msxml2.h, msxml2.idl
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.0 and later

Comentários Gerais

O Nome parâmetro depende de como o valor da tipo parâmetro:

Valor	Descrição
NODE_ATTRIBUTE	O nome do atributo.
NODE_CDATA_SECTION, NODE_COMMENT, NODE_DOCUMENT, NODE_DOCUMENT_FRAGMENT, NODE_TEXT	O NodeName propriedade para esses tipos nó é uma constante valor; o Nome parâmetro será ignorado.
NODE_DOCUMENT_TYPE	O nome do tipo de documento; de exemplo, o xxx em .
NODE_ELEMENT	O nome da marca XML, com qualquer prefixo de espaço para nome incluído se presente.
NODE_ENTITY	O nome da entidade.
NODE_ENTITY_REFERENCE	O nome do relacionado a entidade. Observe que o nome não inclui o E comercial à esquerda ou o ponto-e-vírgula à direita. O nome inclui o espaço para nome se houver algum.
NODE_NOTATION	O nome da notação.
NODE_PROCESSING_INSTRUCTION	O destino, o primeiro token seguinte a

Não é possível criar um nó do tipo NODE_DOCUMENT, NODE_DOCUMENT_TYPE, NODE_ENTITY ou NODE_NOTATION.

Quando um nó é criada, ela é criada no contexto de um espaço para nome se um for fornecido (se a namespaceURI parâmetro é fornecido). Se um não for fornecido, o nó será criada no espaço para nome do documento. Se namespaceURI for especificado, o nó é criado no contexto das namespaceURI Com o prefixo especificado no nome de nó.

Para tipos nó que não têm nomes, o seqüência vazia, " ", deve ser passado como o Nome parâmetro.

Para elementos e referências entidade, quando o namespaceURI parâmetro é algo diferente " " e o Nome parâmetro não contém um prefixo (XXX em xxx:yyy), o namespaceURI é tratado como o espaço para nome usar como padrão.

Atributos não podem ser delimitados para um espaço para nome usar como padrão, e outros elementos não estão qualificados para um determinado espaço para nome; Eles são tratados como sendo do espaço para nome definido pelo próprio documento.

Quando namespaceURI é o seqüência vazia, " ", o nó é criada dentro do espaço para nome especial do atual documento. Criando um nó qualificado sem especificar um nonempty namespaceURI Retorna um erro. Esse membro é uma extensão de Document Object Model (DOM) de W3C (World Wide Web Consortium) (W3C (World Wide Web Consortium)).

Este método se aplica à seguinte interface:

DOMDocument.

See Also

Reference

XML DOM Enumerated Constants

Concepts

nodeName Property