createEntityReference Method

9/8/2008

Cria um novo Entityrefence WScript.Shell.

Sintaxe de script

var objXMLDOMEntityReference = oXMLDOMDocument.createEntityReference(name);

Comentários

Parâmetros de script

• Nome
  Seqüência de caracteres que especifica o nome do relacionado a entidade. Esse nome é subseqüentemente disponível como do objeto de novo NodeName propriedade.

Valor Return script

Objeto. Retorna o novo IXMLDOMEntityReference WScript.Shell.

C/sintaxe C++

HRESULT createEntityReference(
  BSTR name,
  IXMLDOMEntityReference** entityRef
);

Comentários

C/parâmetros C++

• Nome
  [no] Nome do relacionado a entidade. Esse nome é subseqüentemente disponível como do objeto de novo NodeName propriedade.

• entityRef
  [out, retval] Endereço do novo IXMLDOMEntityReference WScript.Shell.

C/valores Return C++

• S_OK
  Valor retornado se bem-sucedido.

• E_INVALIDARG
  Valor retornado se entityRef é 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

Criando um referência de entidade com este método é o mesmo que usar createNode em que tipo valor do parâmetro é NODE_ENTITY_REFERENCE e nenhum espaço para nome for especificado. Não é possível especificar um espaço para nome dentro de Nome parâmetro.

Embora esse método cria o novo objeto no contexto neste documento, ele não adicionar automaticamente o novo objeto para a árvore documento. Em outras palavras, embora o ownerDocument propriedade dos pontos de nó nova para este objeto documento, o parentNode propriedade é definida como NULL. Para adicionar o novo objeto, você deve explicitamente chamar um do nó Inserir métodos, insertBefore método, replaceChild método, ou appendChild Method.

O NodeType propriedade tem o valor NODE_ENTITY_REFERENCE.

Este método se aplica ao seguinte objetos e interfaces:

DOMDocument e IXMLDOMEntityReference.

See Also

Concepts

createNode Method
insertBefore Method
replaceChild Method
nodeName Property
nodeType Property
ownerDocument Property
parentNode Property

Other Resources