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