Partager via

Classes de proxy clientes de références Web et de service Web personnalisé dans les bibliothèques de classes

  • Article

Mise à jour : novembre 2007

Dans le Concepteur d'applications, vous pouvez représenter des références Web aux services Web ou aux classes du proxy client de service Web personnalisées qui sont définies dans les projets référencés ou les assemblys comme points de terminaison consommateur de service Web dans les applications Windows, Office ou ASP.NET. Pour accomplir cette tâche, vous devez prendre certaines mesures pour afficher ces éléments en tant que types « indirects » et connexions aux points de terminaison consommateur de services Web.

Remarque :

Vous ne pouvez pas ajouter directement de points de terminaison consommateur de services Web pour représenter ces éléments en connectant l'application consommateur à un point de terminaison fournisseur de services Web et en déplaçant ces éléments dans une bibliothèque de classes.

Toutefois, avant de prendre ces mesures l'application consommateur de service Web doit être implémentée, et le projet d'application doit contenir un fichier de configuration d'application (Web.config ou App.config). Pour plus d'informations, consultez Implémentation d'applications dans des diagrammes d'application.

Configurations requises pour les références Web d'ingénierie à rebours et les classes de proxy clientes de service Web personnalisées dans les bibliothèques de classes.

Pour les applications ASP.NET, vous devez ajouter les entrées appropriées au fichier de configuration Web.config et les classes proxy avec les noms qualifiés complets et correspondants doivent exister et être recherchées. Toutefois, l'existence de ces entrées dans le fichier de configuration App.config et leur désignation comme type WebServiceURL est suffisante pour les applications Windows et Office. Toutefois, si ces entrées ne sont pas désignées avec le type WebServiceURL, ou si elles sont désignées avec le type String, les classes proxy avec les noms qualifiés complets et correspondants doivent également exister et être recherchées. Pour plus d'informations, consultez Considérations relatives aux classes de proxy cliente de service Web personnalisé.

Lorsqu'une application consommateur de service Web référence des bibliothèques de classes qui définissent des références Web ou des classes de proxy clientes de service Web personnalisées, une référence de projet à cette bibliothèque de classes doit être ajoutée au projet de l'application consommateur du service Web. Toutefois, les paramètres du fichier de configuration du projet d'application substituent ceux du fichier de configuration de bibliothèque de classes. Par conséquent, pour utiliser les paramètres créés dans le fichier de configuration de bibliothèque de classes, vous devez les copier dans le fichier de configuration de l'application consommateur. Pour plus d'informations, consultez Comment : référencer des bibliothèques de classes d'applications dans des diagrammes d'application.

Lorsque ces configurations requises sont accomplies, le Concepteur d'applications effectue une ingénierie à rebours sur ces entrées de fichier de configuration comme points de terminaison consommateur de service Web. De plus, si les URL de service Web spécifiées dans ces entrées correspondent aux URL de points de terminaison fournisseurs de service Web existants, les connexions entre les points de terminaison consommateur et fournisseur apparaissent également. Si aucun point de terminaison fournisseur de services Web correspondant n'existe, mais l'URL peut être utilisée pour localiser un fichier WSDL valide pour le service Web en ajoutant "?wsdl" ou "?disco" à l'URL, puis, un service Web externe est ajouté au diagramme d'application et se connecte au point de terminaison consommateur de services Web. Si un fichier WSDL ne peut pas être trouvé à l'aide de l'URL, le point de terminaison consommateur de services Web reste non connecté.

Modifications qui affectent des points de terminaison consommateur de services Web indirects

Certaines modifications affectent des points de terminaison consommateur de services Web indirects et leurs connexions de la manière suivante :

  • La création ou la suppression de connexions aux points de terminaison consommateur de services Web indirects à partir du diagramme d'application ajoute ou supprime l'URL du service Web connecté à partir du fichier de configuration de l'application consommateur.

  • La suppression de points de terminaison consommateur de services Web indirects du diagramme d'application supprime les entrées de fichier de configuration correspondantes mais pas les références Web ou les classes proxy personnalisées des bibliothèques de classes.

    Remarque :

    Si vous supprimez un point de terminaison indirect, vérifiez que l'application ou les bibliothèques de classes référencées ne référencent plus l'entrée de fichier de configuration correspondante.

  • Le fait de supprimer ou de renommer une classe proxy dans un projet ou l'assembly référencé par une application ASP.NET supprime le point de terminaison consommateur de service Web correspondant.

    Ce résultat se produit parce que l'entrée de fichier de configuration ne correspond plus à une classe proxy. L'ajout d'une classe proxy avec un nom correspondant entraîne la réapparition du point de terminaison consommateur.

  • Le copier coller des points de terminaison consommateur de service Web dont les références Web résident dans une bibliothèque de classes ou un assembly fait apparaître les références Web pour les points de terminaison collés dans le projet racine.

Voir aussi

Référence

Considérations relatives aux classes de proxy cliente de service Web personnalisé

Autres ressources

Référencement de bibliothèques de classes d'applications dans des diagrammes d'application