Saltar para o conteúdo principal
Versão: 20 R7 BETA

DOM GET XML ATTRIBUTE BY NAME

DOM GET XML ATTRIBUTE BY NAME ( refElemento ; nomeAtrib ; valorAtrib )

ParâmetroTipoDescrição
refElementoTextReferência de elemento XML
nomeAtribTextNome de atributo
valorAtribVariableValor atributo

Descrição

O comando DOM GET XML ATTRIBUTE BY NAME permite conhecer o valor de um atributo especificado por seu nome.

Passe em refElemento a referência de um elemento XML e em nomeAtrib o nome do atributo do que deseja conhecer seu valor. O valor se retorna no parâmetro valorAtrib. 4D tentará converter o valor obtido no tipo da variável passada como parâmetro. Se o tipo de variável não for definido, o valor é retornado em tipo texto como padrão.

Se não existir nenhum atributo nomeAtrib no elemento XML, um erro é retornado. Se vários atributos do elemento XML tiverem o mesmo nome, apenas se retornar o valor do primeiro atributo.

Exemplo

Este método se utiliza para recuperar um valor de atributo XML utilizando seu nome:

 var minhaVarBlob : Blob
 var $ref_XML_Pai;$ref_XML_Filho : Text
 var $NumLinha : Integer
 
 $ref_XML_Pai:=DOM Parse XML variable(minhaVarBlob)
 $ref_XML_Filho:=DOM Get first child XML element($ref_XML_Pai)
 DOM GET XML ATTRIBUTE BY NAME($ref_XML_Filho;"N";$NumLinha)

Se este método for aplicado ao exemplo a seguir, $NumLinha contém o valor 1:

Variáveis e conjuntos do sistema

Se o comando tiver sido executado corretamente, a variável sistema OK assume o valor 1. Se ocorrer um erro, assume o valor 0.

Ver também

DOM GET XML ATTRIBUTE BY INDEX
DOM REMOVE XML ATTRIBUTE