TXFANode.SetAttribute Method

procedure SetAttribute(const N, AValue: AnsiString);

Atribui um atributo ao nó, substituindo um nome existente sensível a maiúsculas e minúsculas ou acrescentando um novo atributo

N e AValue contêm bytes UTF-8, correspondendo aos XML names e ao texto do nó; o método converte para a representação de listas de strings do compilador e preserva carateres BMP, carateres suplementares e whitespace inicial ou final ao guardar e recarregar XDP

Um AValue vazio cria ou mantém um atributo presente com valor vazio, serializado como name=""; use RemoveAttribute para eliminar o atributo

HasAttr distingue um atributo presente e vazio de um atributo ausente; AttrValue devolve uma string vazia em ambos os casos

Substituir um valor preserva a posição e a identidade de nó do atributo; repetir a mesma atribuição não acrescenta atributos duplicados nem marca um pacote inalterado como modificado

Um N vazio levanta EHPDFXFAError antes de alterar o nó

O TXFAPacketDOM proprietário impõe os limites de contagem de atributos e de bytes de atributos ao serializar; atributos vazios contam para ambos os limites

Os limites de bytes de atributos contam os bytes serializados do nome UTF-8, do separador e do valor, incluindo todos os bytes de um caráter suplementar

TXFANode Class · XFA Packet DOM