createAttribute Method
9/8/2008
Cria um novo atributo com o nome especificado.
Sintaxe de script
var objXMLDOMAttribute = oXMLDOMDocument.createAttribute(name);
Comentários
Parâmetros de script
- Nome
Seqüência de caracteres que especifica o nome do novo objeto atributo. Esse nome é subseqüentemente disponível como do nó de novo NodeName propriedade.
Valor Return script
Objeto. Retorna o novo IXMLDOMAttribute WScript.Shell.
C/sintaxe C++
HRESULT createAttribute(
BSTR name,
IXMLDOMAttribute** attribute
);
Comentários
C/parâmetros C++
- Nome
[no] Nome do novo objeto atributo. Esse nome é subseqüentemente disponível como do nó de novo NodeName propriedade.
- atributo
[out, retval] Endereço do novo IXMLDOMAttribute WScript.Shell.
C/valores Return C++
- S_OK
Valor retornado se bem-sucedido.
- E_INVALIDARG
Valor retornado se atributo é 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 atributo com este método é o mesmo que usar createNode Method onde o tipo valor do parâmetro é NODE_ATTRIBUTE e nenhum espaço para nome for especificado.
Não é possível criar um atributo Namespace-Qualified usando o createAttribute método. Independentemente se um prefixo de espaço para nome está incluído no Nome, a propriedade namespaceURI Property (IXMLDOMNode) para o novo atributo é definida como um seqüência vazia, " ". Um atributo 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 atributo Namespace-Qualified usando o createNode Method das DOMDocument.
Nenhuma valor de dados é definido para o atributo durante a operação de criação. Você pode definir o valor chamado de setAttribute método do objeto de elemento.
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 associar o atributo com um elemento, chamar o setAttribute método da IXMLDOMElement WScript.Shell.
O NodeType propriedade tem o valor NODE_ATTRIBUTE.
Este método se aplica ao seguinte objetos e interfaces:
DOMDocument, IXMLDOMAttribute, e IXMLDOMElement.
See Also
Concepts
createNode Method
setAttribute Method
namespaceURI Property (IXMLDOMNode)
nodeName Property
nodeType Property
ownerDocument Property
parentNode Property