Partager via

Propriété Nom du nœud

  • Article

Lorsque vous utilisez l'Éditeur BizTalk pour insérer des nœuds dans l'arborescence de schéma, certains nœuds sont censés être renommés, d'autres non. Essentiellement, vous pouvez et devez renommer des nœuds Record , des nœuds d’élément de champ et des nœuds d’attribut de champ . Les noms que vous donnez à ces nœuds deviendront les noms des éléments et des attributs XML du message que le schéma définit.

Dans l’arborescence de schéma, les nœuds que vous ne pouvez pas renommer sont affichés sous la forme de balises XML ; autrement dit, avec les signes inférieurs à (<) et supérieurs à (>). Par exemple, le nœud Schéma , les nœuds de groupe de choix, les nœuds Any Element et Any Attribute sont représentés dans l’arborescence de schéma avec les noms <Schema>, <Choice>, <Any> et <AnyAttribute>, respectivement. La propriété Nom du nœud pour ces nœuds est en lecture seule.

Dans un nœud Record donné, vous ne pouvez pas avoir deux nœuds d’attribut de champ portant le même nom. Toutefois, vous pouvez avoir plusieurs nœuds Field Element ou Record portant le même nom que les nœuds enfants du même nœud Record , à condition qu’ils aient tous le même type de données (comme spécifié par leur propriété Type de données pour les nœuds Field Element ou leur type de structure de données pour les nœuds Record ).

Lorsque vous donnez des noms aux nœuds d’enregistrement , aux nœuds d’élément Field et aux nœuds d’attribut de champ , utilisez des noms descriptifs du rôle de cet élément ou attribut dans le message défini par le schéma. Par exemple, FirstName est probablement un bon choix pour le nom d’un nœud d’élément Field qui sera utilisé pour stocker le prénom d’une personne dans une structure d’adresse. Dans un message d'instance XML dans lequel apparaît le prénom James, l'élément correspondant prendrait l'aspect suivant :

    <FirstName>James</FirstName>

Lorsque vous renommez les nœuds Record , Field Element et Field Attribute nodes, vous devez savoir que tous les caractères ne sont pas autorisés dans les noms de nœuds. Pour plus d’informations sur ces caractères non autorisés, consultez Quels caractères de nom de nœud sont encodés. Bien que l'Éditeur BizTalk permette d'utiliser les caractères non autorisés en les codant, il est souvent plus simple de ne pas y recourir. Pour plus d’informations sur la façon dont les caractères non autorisés sont encodés, consultez Comment les caractères de nom de nœud sont encodés.

Outre les caractères qui ne sont pas autorisés dans les noms de nœuds, sauf s’ils sont encodés dans la représentation XSD du schéma, vous ne devez pas utiliser de mots réservés C# comme noms de nœuds racines dans l’arborescence de schéma (sauf si vous fournissez une valeur de propriété TypeName RootNode valide) ou comme noms de fichier de schéma.

Dans cette section