Compartilhar via


Nomes de elementos e atributos XML declarados (Visual Basic)

Este tópico fornece diretrizes do Visual Basic para nomear atributos e elementos XML em literais do XML. Você pode especificar um nome local ou um nome qualificado em um literal do XML. Um nome qualificado consiste em um prefixo de namespace de XML, dois-pontos e um nome local. Para obter mais informações sobre prefixos de namespace de XML, consulte Literal do Elemento XML.

Regras

Um nome local de um elemento ou atributo no Visual Basic precisa seguir as regras a seguir.

  • Ele pode começar com um namespace. Ele precisa começar com um caractere alfabético ou sublinhado (_).

  • Ele precisa conter apenas caracteres alfabéticos, dígitos decimais, sublinhados, pontos (.) e hifens (-).

  • Ele não pode ter mais de 1.024 caracteres.

  • Dois-pontos que aparecem em nomes indicam a demarcação de namespace. Portanto, você pode usar dois-pontos apenas para especificar um namespace de XML para um nome específico.

Além disso, você deve seguir a diretriz a seguir.

  • A especificação XML 1.0 reserva todos os nomes começando com a cadeia de caracteres "xml", de qualquer variação de capitalização. Portanto, não use esses nomes para seus nomes de elemento e de atributo.

Diretrizes de Comprimento do Nome

Por uma questão prática, um nome deve ser o mais curto possível enquanto ainda identifica claramente a natureza do elemento. Isso melhora a legibilidade do código e reduz o comprimento da linha e o tamanho do arquivo de origem.

No entanto, seu nome não deve ser tão curto que ele não descreva adequadamente o elemento ou como seu código o usa. Isso é importante para a legibilidade do código. Se outra pessoa estiver tentando entendê-lo ou se você mesmo estiver olhando para ele muito tempo depois de escrever, os nomes de elementos apropriados podem economizar tempo.

Sensibilidade de Maiúsculas e Minúsculas em Nomes

Os nomes do elemento XML diferenciam maiúsculas de minúsculas. Isso significa que, quando o compilador do Visual Basic compara dois nomes que diferem apenas em casos alfabéticos, ele os interpreta como nomes diferentes. Por exemplo, ele interpreta ABC e abc como fazendo referência a elementos separados.

Namespaces de XML

Ao criar um literal de elemento XML, você pode especificar o prefixo do namespace de XML para o nome do elemento. Para obter mais informações, consulte Literal do Elemento XML.

Confira também