Partager via

Comment : référencer des bibliothèques de classes d'applications dans des diagrammes d'application

  • Article

Mise à jour : novembre 2007

Dans le Concepteur d'applications, vous pouvez représenter les références à des bibliothèques de classes d'applications sur le diagramme d'application. Même si le Concepteur d'applications ne prend pas en charge la conception ou la représentation directe des bibliothèques de classes sur le diagramme d'application, vous pouvez utiliser un service Web ASP.NET comme façade pour les fonctionnalités implémentées par une bibliothèque de classes. Vous pouvez ensuite effectuer une ingénierie à rebours des références à cette bibliothèque de classes à partir d'autres applications comme connexions de ces applications à ce service Web.

La liste suivante indique les étapes que vous devez suivre pour accomplir cette tâche :

  • Ajoutez un service Web ASP.NET à votre solution et référencez le service Web à partir de la bibliothèque de classes.

  • Référencez la bibliothèque de classes à partir de l'application consommateur, qui peut être une application ASP.NET, Windows ou Office qui existe déjà ou que vous ajoutez au diagramme d'application.

  • Copiez les entrées appropriées du fichier de configuration de bibliothèque de classes vers le fichier de configuration d'application consommateur.

Ces étapes permettent d'effectuer une ingénierie à rebours d'un point de terminaison consommateur de service Web sur l'application consommateur et d'une connexion au service Web ASP.NET.

Conseil :

Vous pouvez également utiliser cette technique pour visualiser des références Web ou classes du proxy client de service Web personnalisées définies dans les bibliothèques de classes comme points de terminaison consommateurs de service Web et connexions sur le diagramme d'application. Toutefois, vous ne pouvez pas représenter ces éléments à l'aide du Concepteur d'applications en concevant d'abord les points de terminaison consommateurs de service Web et en ajoutant ensuite les entrées de fichier de configuration appropriées. Pour plus d'informations, consultez Classes de proxy clientes de références Web et de service Web personnalisé dans les bibliothèques de classes.

Pour référencer un service Web à partir d'une bibliothèque de classes

  1. Ouvrez le fichier de diagramme d'application (.ad).

  2. Ajoutez un service Web ASP.NET au diagramme.

    Conseil :

    Pour plus d'informations, consultez Comment : définir des applications sur les diagrammes de l'application.

    Ce service Web permettra aux autres applications de référencer une bibliothèque de classes en utilisant le service Web.

  3. Sur le diagramme, choisissez une application Windows ou ASP.NET existante comme application consommateur, ou ajoutez-en une nouvelle.

  4. Implémentez le service Web ASP.NET et l'application consommateur, si ce n'est pas déjà fait.

    Remarque :

    Pour plus d'informations, consultez Comment : implémenter des applications dans des diagrammes d'application. Le service Web ASP.NET doit être implémenté avant de pouvoir ajouter une référence de service Web à la bibliothèque de classes. L'application consommateur doit être implémentée afin de pouvoir modifier ultérieurement son fichier de configuration.

    L'application consommateur utilisera les fonctionnalités de la bibliothèque de classes pour appeler le service Web.

  5. Si nécessaire, ajoutez un projet Bibliothèque de classes nouveau ou existant à la solution.

    Remarque :

    Un fichier App.config doit exister dans le projet Bibliothèque de classes afin que les entrées de fichier de configuration appropriées soient ajoutées quand la référence Web est ajoutée.

  6. Si le fichier de configuration est absent de la bibliothèque de classes, du service Web ASP.NET ou du projet d'application consommateur, ajoutez le fichier de configuration approprié (App.config ou Web.config) au projet Bibliothèque de classes.

    Conseil :

    Pour ajouter un fichier de configuration, sélectionnez le nœud de projet dans l'Explorateur de solutions, choisissez Ajouter un nouvel élément dans le menu Projet et Fichier de configuration de l'application ou Fichier de configuration Web selon le cas dans la boîte de dialogue Ajouter un nouvel élément.

  7. Dans l'Explorateur de solutions, sélectionnez le nœud de projet Bibliothèque de classes et choisissez Ajouter une référence Web dans le menu Projet.

  8. Dans la boîte de dialogue Ajouter une référence Web, cliquez sur Services Web dans cette solution, choisissez le service Web que vous avez créé, puis cliquez sur Ajouter une référence.

    Dans l'Explorateur de solutions, une référence de service Web est ajoutée au dossier Web References dans le projet Bibliothèque de classes.

  9. Dans l'Explorateur de solutions, sélectionnez le nœud de projet Bibliothèque de classes et choisissez Générer <NomBibliothèqueClasses> dans le menu Générer.

    Conseil :

    Vous pouvez aussi cliquer avec le bouton droit sur le nœud de projet et choisir Générer. Après avoir ajouté de nouvelles références Web, régénérez la bibliothèque de classes avant de copier les entrées de fichier de configuration et d'ajouter la référence de bibliothèque de classes. Sinon, il peut être impossible d'effectuer une ingénierie à rebours des références de service Web dans les bibliothèques de classes Visual Basic si la bibliothèque de classes est générée en tant que dernière étape après avoir copié les entrées de fichier de configuration et ajouté la référence de bibliothèque de classes à l'application consommateur. Pour plus d'informations, consultez Dépannage de diagrammes d'application.

Vous êtes désormais prêt à ajouter une référence de bibliothèque de classes à l'application consommateur.

Conseil :

Si le fichier de configuration est manquant ou supprimé du projet Bibliothèque de classes après avoir ajouté les références Web au projet, vous pouvez ajouter un nouveau fichier de configuration au projet. Toutefois, les références Web ne seront pas ajoutées automatiquement au fichier de configuration. Vous devrez supprimer les références Web du projet, puis les y ajouter de nouveau, ce qui crée un fichier de configuration contenant des entrées pour les références Web ajoutées.

Pour référencer la bibliothèque de classes à partir de l'application consommateur

  1. Dans l'Explorateur de solutions, sélectionnez le nœud de projet d'application consommateur et choisissez l'un des éléments suivants :

    • Pour une application Windows ou Office, choisissez Ajouter une référence dans le menu Projet.

    • Pour une application ASP.NET, choisissez Ajouter une référence dans le menu Site Web.

      Conseil :

      Vous pouvez également cliquer avec le bouton droit sur le nœud projet racine et choisissez Ajouter une référence.

  2. Dans l'onglet Projets, sélectionnez le projet Bibliothèque de classes et cliquez sur OK.

Pour copier des entrées du fichier de configuration de bibliothèque de classes vers le fichier de configuration d'application consommateur

  1. Ouvrez le fichier App.config dans le projet Bibliothèque de classes et le fichier de configuration dans le projet d'application consommateur.

  2. À partir du fichier App.config de bibliothèque de classes, copiez les entrées suivantes à partir des sections <configSections> et <applicationSettings>.

    Remarque :

    Incluez les balises <configSections> ou <applicationSettings> englobantes si elles n'existent pas dans le fichier de configuration de destination. Si vous copiez des entrées pour plusieurs bibliothèques de classes, copiez un seul jeu de balises <sectionGroup> « applicationSettings ».

    		 
     <configSections>
   <sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=VersionNumber, Culture=neutral, PublicKeyToken=b77a5c561934e089"><section name="ClassLibraryName.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" /></sectionGroup>
</configSections>

<applicationSettings>
   <ClassLibraryName.Settings>      <setting name="ClassLibraryName_WebServiceProxyClassName" serializeAs="String"><value>http://WebServiceURL.asmx</value></setting></ClassLibraryName.Settings>
</applicationSettings>

  3. Collez les entrées copiées dans la section <configuration> qui suit immédiatement la balise <configuration> dans le fichier de configuration de l'application consommateur.

  4. Dans l'Explorateur de solutions, sélectionnez le nœud de la solution de la racine et choisissez Générer la solution dans le menu Générer.

    Conseil :

    Vous pouvez également cliquer avec le bouton droit sur le nœud de la solution de la racine et choisir Générer la solution.

    Sur le diagramme d'application, une ingénierie à rebours d'un point de terminaison consommateur de service Web est effectuée sur l'application consommateur et ce point est connecté au service Web ASP.NET.

Il est possible que l'ingénierie à rebours des références de service Web ne soit pas effectuée correctement dans les scénarios suivants :

  • Il est possible que l'ingénierie à rebours des références de service Web ne soit pas effectuée correctement lorsqu'un projet Windows et un projet Web ASP.NET font tous deux référence à la même bibliothèque de classes.

    Pour résoudre cette condition, fermez le diagramme d'application et supprimez les références à la bibliothèque de classes partagée des projets Windows et Web ASP.NET. Ajoutez d'abord la référence de bibliothèque de classes au projet Web ASP.NET, ouvrez le diagramme d'application, puis ajoutez la référence de bibliothèque de classes au projet Windows. Pour plus d'informations, consultez Dépannage de diagrammes d'application.

  • Il est possible que l'ingénierie à rebours des références de service Web dans les bibliothèques de classes Visual Basic ne soit pas effectuée correctement lorsqu'une application consommateur référence plusieurs bibliothèques de classes et que chacune de ces bibliothèques contient une référence Web à un service Web différent.

    Pour résoudre cette condition, mettez à jour toutes les références Web dans les bibliothèques de classes affectées. Cliquez avec le bouton droit sur chaque référence Web dans chaque bibliothèque de classes affectée, choisissez Mettre à jour la référence Web, puis régénérez la solution entière. Après avoir ajouté de nouvelles références Web et recréé les bibliothèques de classes correspondantes, régénérez une nouvelle fois la solution entière pour effectuer une ingénierie à rebours de ces références Web.

Voir aussi

Tâches

Procédure pas à pas : représentation de connexions de service Web indirectes

Concepts

Vue d'ensemble des applications ASP.NET dans les diagrammes d'application

Autres ressources

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