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:
See Also
Concepts
appendChild Method
createNode Method
createNode Method
insertBefore Method
replaceChild Method
namespaceURI Property (IXMLDOMNode)
nodeName Property
nodeType Property
ownerDocument Property
parentNode Property