Partager via


Nom des attributs et des éléments XML déclarés (Visual Basic)

Cette rubrique fournit des indications Visual Basic pour nommer des éléments XML et des attributs dans les littéraux XML. Dans un littéral XML, vous pouvez spécifier un nom local ou un nom qualifié. Un nom qualifié se compose d'un préfixe d'espace de noms XML, de deux-points et d'un nom local. Pour plus d'informations sur les préfixes d'espace de noms XML, consultez Littéral d'élément XML (Visual Basic).

Règles

Dans Visual Basic, le nom local d'un élément ou d'un attribut doit adhérer aux règles suivantes.

  • Il peut commencer par un espace de noms. Il doit commencer par un caractère alphabétique ou un trait de soulignement (_).

  • Il doit ne doit contenir que des caractères alphabétiques, des chiffres décimaux, des traits de soulignement, des points (.) et des traits d'union (-).

  • Il ne doit pas dépasser 1.024 caractères.

  • Les deux-points qui figurent dans les noms indiquent la délimitation d'espace de noms. Par conséquent, vous ne pouvez les utiliser que pour spécifier un espace de noms XML pour un nom particulier.

De plus, vous devez respecter l'indication suivante.

  • La spécification XML 1.0 préserve tous les noms commençant par une chaîne « xml » de toute variation de mise en majuscules. N'utilisez donc pas ces noms pour vos noms d'éléments et d'attributs.

Indications sur la longueur du nom

Pour des raisons d'ordre pratique, un nom devrait être aussi court que possible tout en identifiant clairement la nature de l'élément. La lisibilité de votre code s'en trouve améliorée, et la justification et la taille de fichier source réduites.

Il ne devrait toutefois pas être court au point de mal décrire l'élément ou son utilisation par votre code. Cette considération est importante pour la lisibilité de votre code. Si une autre personne a du mal à le comprendre ou si vous devez l'observer longtemps après l'avoir écrit, ce nom prend du temps ; les noms d'éléments bien choisis permettent en revanche d'économiser du temps.

Respect de la casse dans les noms

Les noms d'éléments XML respectent la casse des lettres. Cela signifie que lorsque le compilateur Visual Basic compare deux noms qui ne diffèrent que par la casse des lettres, il les interprète comme deux noms différents. Il interprète, par exemple, ABC et abc comme deux éléments distincts.

Espaces de noms XML

Lorsque vous créez un littéral d'élément XML, vous pouvez spécifier le préfixe d'espace de noms XML pour le nom d'élément. Pour plus d'informations, consultez Littéral d'élément XML (Visual Basic).

Voir aussi

Référence

Littéral d'élément XML (Visual Basic)

Autres ressources

Création de code XML dans Visual Basic