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

  • Article

Mise à jour : novembre 2007

Dans le Concepteur d'applications, vous pouvez définir des applications ASP.NET qui exposent des services Web basés sur des fichiers .asmx, documenter un contenu Web, ou les deux en ajoutant ou en utilisant les points de terminaison appropriés. Lorsque vous ajoutez une application de service Web ASP.NET ou une application Web ASP.NET au diagramme d'application, la définition d'application possède un service Web par défaut ou un point de terminaison fournisseur de contenu Web, respectivement. Toutefois, vous pouvez ajouter ou supprimer des points de terminaison fournisseurs de l'un et l'autre type sur une application ASP.NET. Vous pouvez également substituer des points de terminaison fournisseurs de services Web sur les applications ASP.NET.

Pour plus d'informations, consultez les rubriques suivantes :

Les sections suivantes contiennent plus d'informations sur les applications ASP.NET sur le diagramme d'application :

  • Définition de services Web dans des applications ASP.NET

  • Définition d'applications Web ASP.NET

  • Implémentation d'applications ASP.NET

  • Implémentation d'applications consommateur de services Web

Définition de services Web dans des applications ASP.NET

Un service Web sur une application ASP.NET est représenté par un point de terminaison fournisseur de services Web. Un point de terminaison consommateur de service Web sur une application représente un point de connexion à un service Web. Vous pouvez définir, examiner, et modifier des opérations pour les services Web sur les applications ASP.NET.

Définition, examen, et modification d'opérations

Dans le Concepteur d'applications, vous pouvez définir, afficher, et modifier des opérations et des paramètres pour chaque service Web sur une application ASP.NET par l'intermédiaire de son point de terminaison fournisseur de services Web correspondant.

Conseil :

Le Concepteur d'applications prend en charge également une approche pilotée par contrat où vous pouvez créer un point de terminaison fournisseur de services Web sur une application ASP.NET avec les signatures d'opération prédéfinies et les types basés sur un fichier WSDL ou un fichier .disco existant. Pour plus d'informations, consultez Points de terminaison de service Web basés sur des fichiers WSDL.

Vous pouvez définir une ou plusieurs opérations à l'aide des éléments suivants :

  • Nom d'opération et type de retour, si besoin.

  • Paramètres d'opération, y compris leurs noms, types si besoin, et modificateurs qui décrivent comment passer chaque paramètre.

  • Commentaires facultatifs pour chaque opération ou paramètre.

Pour plus d'informations, consultez Comment : définir des opérations pour les services Web ASP.NET.

Définition d'opérations dans la fenêtre Détails de service Web

Dans le Concepteur d'applications, vous pouvez utiliser la fenêtre Détails de service Web pour définir, afficher ou modifier des opérations pour un point de terminaison fournisseur de services Web sur une application ASP.NET. Pour les services Web sur les applications ASP.NET implémentées, cette fenêtre n'affiche correctement que les opérations de service Web lorsque les méthodes Web correspondantes sont déclarées pleinement dans une définition de classe unique dans un fichier de code séparé ou un fichier « code-behind ».

Le tableau suivant décrit des scénarios où la fenêtre Détails de service Web n'affiche pas correctement les opérations de service Web.

Scénario

Fenêtre Détails de service Web

Le fichier .asmx contient la définition de classe de service Web inline.

N'affiche pas d'opérations.

Méthodes Web qui sont déclarées par les attributs sur les méthodes d'une interface implémentées par une classe de service Web.

- ou -

Une classe étend une classe de base qui définit des méthodes Web.

Affiche uniquement les opérations qui correspondent aux méthodes Web déclarées dans la classe référencée par le fichier .asmx.

Fichiers code-behind qui définissent des services Web qui contiennent plusieurs liaisons.

Affiche uniquement les opérations associées à la première liaison.

Pour plus d'informations, consultez Considérations relatives à l'ingénierie à rebours dans les solutions existantes.

Référencer des types pour les opérations et les paramètres

Référencer un type pour une opération ou un paramètre est une opération qui convient en fonction du langage de programmation choisi pour l'application. Lorsque vous définissez une opération ou un paramètre, vous pouvez choisir l'une des actions suivantes :

  • Laisser le type vide ou affecter la valeur par défaut si besoin est.

  • Sélectionnez un type dans la liste déroulante de type IntelliSense.

  • Référencer un type défini dans les autres bibliothèques de types et les projets, si une référence à ces bibliothèques ou à ces projets existe dans le projet d'application.

  • Référencer un type que vous projetez de définir ultérieurement.

Si vous définissez des opérations et des paramètres à l'aide de la fenêtre Détails de service Web, la prise en charge IntelliSense est disponible pour référencer des types pour Visual Basic et Visual C#. Une fois l'application implémentée, vous pouvez définir des types nouveaux ou redéfinir des types existants. Pour plus d'informations, consultez Comment : définir des types d'opérations et de paramètres pour les services Web ASP.NET.

Définition d'applications Web ASP.NET

Dans le Concepteur d'applications, un point de terminaison fournisseur de contenu Web sur une application ASP.NET représente un point de connexion auquel le contenu Web est exposé, par exemple, des fichiers HTML ou Active Server Pages (fichiers .aspx). Un point de terminaison consommateur de contenu Web sur une application représente un point de connexion client au contenu Web.

Les points de terminaison de contenu Web ne prennent pas en charge la génération ou la synchronisation du code, ils ne génèrent et ne synchronisent pas non plus les entrées du fichier de configuration (.config) de l'application. Toutefois, vous pouvez utiliser ces points de terminaison pour documenter des configurations requises et définir des contraintes sur la prise en charge de contenu Web pour un site Web hébergé sur un serveur Web.

Pour plus d'informations, consultez les rubriques suivantes :

Implémentation d'applications ASP.NET

Lorsque vous implémentez une application ASP.NET, Visual Studio génère le projet correspondant avec les fichiers projet appropriés. Vous pouvez implémenter des applications ASP.NET comme projets Web de serveur de développement ASP.NET (basé sur un système de fichiers) ou comme projets Web de Services Internet (IIS) (basé sur HTTP). Pour plus d'informations, consultez Types et prototypes d'applications pour la définition d'applications et Comment : choisir un type de site Web pour des applications ASP.NET.

Tous les projets d'application ASP.NET comprennent un fichier de configuration Web.config dans le cadre du projet racine dans l'Explorateur de solutions. Dans le cas d'une application ASP.NET comportant un ou plusieurs points de terminaison fournisseurs de services Web, le projet inclut également un fichier .asmx et un fichier de classe de service Web, fichier de code spécifique à un langage de programmation ou « fichier code-behind », pour chaque point de terminaison fournisseur de services Web.

Dans la classe de service Web, une liaison WSDL avec une liaison unique et un port unique est associée à chaque point de terminaison fournisseur de services Web. Chaque opération de service Web, ainsi que les commentaires, apparaît sous la forme d'une méthode indiquant l'attribut WebMethod dans la classe de service Web. Pour tous points de terminaison fournisseurs de services Web créés à partir d'un fichier WSDL ou un fichier .disco, les fichiers de classe qui définissent des types XML complexes prenant en charge la sérialisation XML pour les opérations dans le fichier WSDL ou les fichiers de schéma XML connexes sont également inclus dans le projet d'application. Vous pouvez achever ensuite l'implémentation de chaque opération en ajoutant le code du corps de la méthode nécessaire. Pour plus d'informations, consultez Points de terminaison de service Web basés sur des fichiers WSDL.

Remarque :

Les descriptions WSDL que vous spécifiez dans les commentaires d'opération apparaissent également dans le fichier WSDL. Vous pouvez également personnaliser la génération du fichier WSDL. Pour plus d'informations, consultez Génération de fichiers WSDL pour les services Web ASP.NET.

Si le code source pour une application implémentée est considéré comme la définition principale, les modifications que vous apportez à un service Web ASP.NET dans le Concepteur d'applications, la fenêtre Détails de service Web ou un éditeur de code se synchronisent entre eux à l'ouverture du diagramme d'application. Toutefois, un diagramme fermé se synchronise avec les modifications apportées au code à l'ouverture ultérieure du diagramme. Pour plus d'informations, consultez Comment : implémenter des applications dans des diagrammes d'application.

Assignations dynamiques de port pour les applications Web ASP.NET

Au cours de l'implémentation d'une application ASP.NET basée sur un système de fichiers qui génère un projet de serveur Web de développement ASP.NET, un numéro de port est assigné au site Web associé. Étant donné que les applications ASP.NET basées sur un système de fichiers sont définies pour utiliser des ports dynamiques par défaut, ce numéro de port peut changer.

Conseil :

Vous pouvez consulter le numéro de port dans la fenêtre Propriétés en cliquant avec le bouton droit sur le projet d'application ASP.NET dans l'Explorateur de solutions.

Par exemple, les nouveaux numéros de port sont assignés à des applications ASP.NET basées sur un système de fichiers dans les conditions suivantes :

  • Lors de l'ouverture d'une solution qui contient ces types d'applications ASP.NET ainsi que des applications consommateur de service Web implémentées comportant des références aux services Web exposés par ces applications ASP.NET.

  • Lors de l'utilisation du Débogueur Visual Studio pour la première fois dans une solution qui contient ces types d'applications ASP.NET.

Si les projets de l'application consommateur du service Web associés sont dans la même solution, ils sont mis à jour automatiquement. Toutefois, s'ils ne sont pas dans la même solution, par exemple s'ils se trouvent dans des solutions partitionnées, leurs références Web ne seront pas mises à jour et pointeront vers des services Web inexistants.

Remarque :

Si vous utilisez le contrôle de code source, et les projets de l'application consommateur de services Web associés sont archivés dans le contrôle de code source, vous devez extraire ces projets pour mettre à jour les références Web.

Pour contrôler l'assignation des numéros de port, vous pouvez configurer le projet d'une application ASP.NET basée sur un système de fichiers pour qu'il n'utilise pas de ports dynamiques.

Remarque :

Au terme de cette opération, le démarrage du Débogueur Visual Studio peut générer une erreur indiquant que le port existant est en cours d'utilisation. Dans ce cas, vous devez modifier manuellement le numéro de port pour le projet de site Web. Lorsque vous modifiez le numéro de port, Visual Studio génère un avertissement indiquant que les références Web existantes ne seront plus valides. Si le diagramme d'application est ouvert, les références Web sont mises à jour. Toutefois, si le diagramme d'application n'est pas ouvert, vous devez supprimer, puis ajouter ces références Web.

Pour plus d'informations, consultez les rubriques suivantes :

Implémentation d'applications consommateur de services Web

Lorsque vous implémentez une application avec un ou plusieurs points de terminaison consommateurs de services Web, une référence Web est générée pour chaque point de terminaison consommateur de service Web, si le fichier WSDL utilisé pour générer la référence Web est disponible. Ce fichier WSDL est spécifié par la propriété de l'emplacement WSDL sur le point de terminaison consommateur de services Web. Lorsque la référence Web est générée, l'URL de service Web dans le fichier de configuration de l'application consommateur est également générée.

Remarque :

Si une application de fournisseur de services Web ASP.NET connectée est implémentée en même temps, le fichier WSDL sera disponible au cours de l'implémentation. Toutefois, si l'application fournisseur de services Web connectée n'est pas implémentée lorsque le point de terminaison consommateur est implémenté, le point de terminaison consommateur affiche un avertissement qui indique que le point de terminaison consommateur n'a pas pu être implémenté. Lorsqu'une application fournisseur de services Web est implémentée, tous les points de terminaison consommateurs connectés sont implémentés automatiquement si l'application consommateur est implémentée. Pour plus d'informations, consultez Dépannage de diagrammes d'application.

La référence Web gère la création de la classe du proxy client de service Web et les types proxy pour appeler des opérations de service Web et gérer la communication de messages SOAP. Vous pouvez également effectuer une ingénierie à rebours et afficher des classes du proxy client de services Web personnalisées, y compris les classes proxy personnalisées et les références Web définies dans les bibliothèques de classes, comme points de terminaison consommateurs de services Web. Pour plus d'informations, consultez Création d'un proxy de service Web XML et Considérations relatives aux classes de proxy cliente de service Web personnalisé.

Remarque :

Vous pouvez également activer la documentation XML pour une application consommateur de services Web ou Windows après implémentation afin d'inclure des commentaires d'opération dans un fichier XML. Ce fichier est généré après que vous avez généré le projet d'application. Pour générer le fichier XML, vous devez activer la documentation XML pour le projet Windows. Pour les projets Windows Visual Basic, consultez Comment : générer la documentation XML pour un projet. Pour les projets Windows Visual C#, consultez Comment : définir les propriétés de la génération (C#) et Générer, page du Concepteur de projets (C#).

Voir aussi

Autres ressources

Définition d'applications ASP.NET sur les diagrammes d'application