Considérations sur le changement de nom des points de terminaison
Mise à jour : novembre 2007
Dans le Concepteur d'applications le et Concepteur de systèmes, vous pouvez renommer des points de terminaison sur des applications, des systèmes et des membres de ces systèmes, selon le type de point de terminaison. Lorsque vous renommez un point de terminaison, prenez en compte les considérations suivantes :
Vous devez choisir un nom unique pour le point de terminaison. Les noms de points de terminaison ne doivent pas entrer en conflit avec les noms de ressources ou, dans le cas d'un système, les noms de membres de système.
Les caractères qui sont incompatibles avec le modèle de définition de système (SDM) sont omis des noms. Si le nom résultant est en conflit avec un autre nom ou un nom SDM réservé, un ordinal est ajouté au nom ou incrémenté s'il en existe déjà un. Pour plus d'informations sur SMD, consultez Vue d'ensemble du modèle de définition de système (SDM).
Renommer un point de terminaison sur une définition d'application renomme ce point de terminaison sur toutes les utilisations de cette définition dans les définitions de système. Renommer un point de terminaison sur un membre d'une définition de système renomme le point de terminaison sur la définition d'application et toutes les utilisations de cette définition dans d'autres définitions de système.
Lorsque vous renommez un point de terminaison fournisseur, Visual Studione met pas à jour le point de terminaison consommateur correspondant à moins qu'il existe déjà une connexion entre ces points de terminaison sur le diagramme d'application.
Si nécessaire, vous pouvez renommer des points de terminaison sur une définition d'application avant d'implémenter cette application. Toutefois, une fois cette application implémentée, renommer le point de terminaison affecte les fichiers projet associés de diverses façons en fonction du point de terminaison.
Par exemple, lorsque vous renommez un point de terminaison fournisseur de services Web .NET, prenez en compte les considérations suivantes :
Par défaut, le nom du point de terminaison est basé sur le nom du service WSDL. Par exemple, lorsque vous procédez pour la première fois à l'ingénierie à rebours d'un point de terminaison de Service Web .NET, le nom du point de terminaison est basé sur le nom du service WSDL.
Si le nom de classe de service Web est le même que le nom de point de terminaison, le fait de renommer le point de terminaison renomme le nom de classe de service Web.
.gif "Remarque")
Remarque :Renommer le nom de classe de service Web renomme le nom du fichier de classe du service Web et le nom du service WSDL s'ils sont identiques au nom de classe de service Web. Renommer le nom du service WSDL renomme le nom du fichier .asmx et le nom de liaison WSDL si ces derniers sont identiques au nom du service WSDL.
Par conséquent, si vous modifiez le nom de point de terminaison, il est possible que cette modification se propage du nom de point de terminaison au nom de classe, du nom de classe au nom du service WSDL, du nom du service WSDL au nom de fichier .asmx, puis le nom de liaison WSDL.
Si renommer un point de terminaison fournisseur de services Web implémenté entraîne la modification du nom de fichier .asmx, les références Web et les classes proxy sous-jacentes associées sont supprimées, ce qui entraîne la non implémentation des points de terminaison consommateur de services Web correspondants. Vous devrez réimplémenter les points de terminaison consommateur pour générer de nouvelles références Web. Si vous utilisez le contrôle de code source, vous devrez peut-être également archiver tous les fichiers affectés avant de réimplémenter. Pour réimplémenter un point de terminaison consommateur de services Web, cliquez avec le bouton droit sur le point de terminaison et choisissez Implémenter.
Si l'attribution d'un nouveau nom à un point de terminaison fournisseur de services Web implémenté entraîne la modification du nom du service Web, les classes proxy associées aux références Web au service Web ne correspondront plus au nom du service. Par conséquent, l'application peut ne pas se compiler. Pour résoudre cette condition, corrigez les emplacements dans le code qui référencent les anciens noms de services.
Voir aussi
Tâches
Comment : renommer des points de terminaison sur des applications