Saltar para o conteúdo principal
Versão: Próximo

DOM SET XML ELEMENT NAME

DOM SET XML ELEMENT NAME ( refElemento ; nomeElemento )

ParâmetroTipoDescrição
refElementoTextReferência de elemento XML
nomeElementoTextNovo nome do elemento

Descrição

O comando DOM SET XML ELEMENT NAME permite modificar o nome do elemento designado por refElemento.

Passe em refElemento a referência do elemento a renomear e em nomeElemento o novo nome do elemento. O comando também cuida de atualizar as etiquetas de abertura e fechamento do elemento.

Exemplo

No recurso abaixo XML:

<Book>
   <Title>O melhor vendedor </Title>
</Book>

Se o código abaixo for executado, suponndo que vRefElem contenha a referência do elemento ‘Book’:

 DOM SET XML ELEMENT NAME(vRefElem;"MelhorVendedor")

Obtemos:

<MelhorVendedor>
   <Title>O melhor vendedor</Title>
</MelhorVendedor>

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.

Gestão de erros

Um erro é gerado quando:

  • A referência do elemento não for válida
  • O novo nome do elemento a ser criado não for válido (por exemplo, se começa com um número).

Ver também

DOM GET XML ELEMENT NAME