createElement Method

9/8/2008

Cria um nó elemento usando o nome especificado.

Sintaxe de script

var objXMLDOMElement = oXMLDOMDocument.createElement(tagName);

Comentários

Parâmetros de script

• TagName
  Seqüência de caracteres especificando o nome para o novo nó elemento. O nome é com diferenciação de maiúsculas e minúsculas. Esse nome é subseqüentemente disponível como do nó de elemento NodeName propriedade.

Valor Return script

Objeto. Retorna o IXMLDOMElement objeto para o novo elemento.

C/sintaxe C++

HRESULT createElement(
  BSTR tagName,
  IXMLDOMElement** element
);

Comentários

C/parâmetros C++

• TagName
  [no] Nome para o novo nó elemento. É com diferenciação de maiúsculas e minúsculas. Esse nome é subseqüentemente disponível como do nó de elemento NodeName propriedade.

• elemento
  [out, retval] Endereço das IXMLDOMElement interface para o novo elemento.

C/valores Return C++

• S_OK
  Valor retornado se bem-sucedido.

• E_INVALIDARG
  Valor retornado se elemento é 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 elemento com este método é o mesmo que usar createNode em que tipo valor do parâmetro é NODE_ELEMENT e nenhum espaço para nome for especificado.

Não é possível criar um elemento Namespace-Qualified usando o createElement método. Independentemente se um prefixo de espaço para nome está incluído no TagName, o namespaceURI Property (IXMLDOMNode) para o novo nó elemento é definido como um seqüência vazia, " ". Um nó elemento construído como parte de uma operação carregar documento XML nunca será ter tanto um prefixo e um vazio Namespace URI (Uniform Resource Identifier) (URI). Você só pode criar um elemento Namespace-Qualified usando o createNode método da DOMDocument WScript.Shell.

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_ELEMENT.

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

DOMDocument e IXMLDOMElement.

See Also

Concepts

appendChild Method
createNode Method
createNode Method
insertBefore Method
replaceChild Method
namespaceURI Property (IXMLDOMNode)
nodeName Property
nodeType Property
ownerDocument Property
parentNode Property