Partager via

Comment : définir des opérations pour les services Web ASP.NET

  • Article

Mise à jour : novembre 2007

Dans le Concepteur d'applications et le Concepteur de systèmes, vous pouvez définir des opérations pour un point de terminaison fournisseur de service Web .NET. Vous pouvez effectuer cette tâche à l'aide de la fenêtre Détails de service Web. Pour plus d'informations, consultez Vue d'ensemble des applications ASP.NET dans les diagrammes d'application.

Conseil :

Vous pouvez créer un point de terminaison fournisseur de service Web .NET avec les signatures et types d'opérations prédéfinis en spécifiant un fichier WSDL ou .disco, puis modifier ces opérations dans la fenêtre Détails de service Web. Pour plus d'informations, consultez Comment : ajouter des points de terminaison à des applications.

Lorsque vous définissez les opérations pour un point de terminaison fournisseur de service Web .NET, vous les définissez pour toutes les utilisations de ce point de terminaison. Après avoir défini ces opérations, vous pouvez les modifier à tout moment à l'aide de la fenêtre Détails de service Web. Après avoir implémenté une application ASP.NET avec un point de terminaison fournisseur de service Web .NET, vous pouvez modifier les opérations du point de terminaison via la fenêtre Détails de service Web ou via le code, qui restent synchronisés. Pour plus d'informations, consultez Comment : modifier des opérations pour les services Web ASP.NET.

Remarque :

Un projet d'application ASP.NET contient un fichier de classe de service Web pour chaque point de terminaison fournisseur de service Web sur l'application. Chaque fichier de classe de services Web contient les signatures d'opération pour le point de terminaison fournisseur de services Web correspondant. Chaque signature d'opération, ainsi que les commentaires, apparaît sous la forme d'une méthode avec l'attribut WebMethod dans le fichier de classe de service Web. Vous pouvez ajouter le code du corps de la méthode approprié pour compléter l'implémentation de chaque opération.

Pour définir une opération de service Web

  1. Sur le diagramme, sélectionnez un point de terminaison fournisseur de service Web.

  2. Dans le menu Diagramme, sélectionnez Définir les opérations.

    Conseil :

    Vous pouvez aussi cliquer avec le bouton droit sur le point de terminaison pour choisir Définir les opérations.

    La fenêtre Détails de service Web s'affiche.

  3. Sur la ligne d'opération dans la fenêtre Détails de service Web, cliquez sur < ajouter une opération > sous Nom et nommez l'opération.

  4. Sur la même ligne sous Type, spécifiez le type de retour d'opération, si nécessaire. Si vous n'avez pas besoin de spécifier un type, passez à l'étape 7.

    Remarque :

    Par défaut, une opération ne retourne pas de données sauf si elle est explicitement définie pour le faire. La représentation d'une opération qui ne retourne pas de données dépend du langage spécifié pour le service Web. Si vous utilisez Visual Basic, aucun type de retour d'opération n'est spécifié. Lors de l'utilisation de Visual C# ou Visual J#, le type de retour par défaut pour une opération est void. Les types d'interfaces ne peuvent pas être sérialisés et génèrent une erreur lors de la création de références Web associées au service Web.

  5. Pour sélectionner un type, commencez à taper pour consulter la liste des types.

    Au fur et à mesure que vous tapez, la liste s'ouvre et affiche des types disponibles.

    Conseil :

    Si le type que vous souhaitez n'est pas dans la liste des types, utilisez le nom de type qualifié complet, spécifiez un type défini dans un autre projet ou une bibliothèque de types ou spécifiez un type nouveau à définir après l'implémentation. Pour terminer de spécifier le type, continuez à taper le nom du type que vous souhaitez.

  6. Quittez la cellule en appuyant sur ENTREE ou cliquant sur une autre cellule.

    Remarque :

    Appuyer sur la touche TABULATION remplace le type que vous avez spécifié par le type correspondant le plus proche dans la liste des types.

  7. Sous Résumé, ajoutez les commentaires relatifs à l'opération.

    Conseil :

    Pour ajouter plus d'informations, cliquez sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Description. Vous pouvez spécifier ensuite des commentaires supplémentaires pour la description WSDL, le type de retour d'opération, s'il y en a un, et d'autres remarques. Les informations de la description WSDL que vous spécifiez apparaissent dans le fichier WSDL.

Avant d'implémenter une application ASP.NET, la liste des types affiche uniquement les types qui sont définis dans la bibliothèque principale de Microsoft (MSCorLib.dll) ainsi que plusieurs autres bibliothèques de types implicitement référencées. Toutefois, vous pouvez référencer des types définis dans d'autres bibliothèques de types et de projets, ou vous pouvez référencer des types que vous projetez de définir plus tard dans le code ou à l'aide du Concepteur de classes une fois l'application implémentée.

Si vous référencez des types qui sont définis dans les autres projets ou les bibliothèques de types, vous devez ajouter des références à ces projets ou ces bibliothèques une fois l'application implémentée. La liste des types inclura tous les types qui sont définis dans tout explicitement projets référencés et bibliothèques de types. Pour plus d'informations, consultez Comment : ajouter et supprimer des références dans Visual Studio (C#).

Si vous référencez des types que vous projetez de définir ultérieurement, ces types n'apparaissent pas dans la liste des types tant que vous n'avez pas ajouté un fichier de classe ou un diagramme de classes au projet d'application pour définir le type une fois l'application implémentée. Pour plus d'informations, consultez Comment : définir des types d'opérations et de paramètres pour les services Web ASP.NET.

Après avoir défini une opération, vous pouvez définir ses paramètres ou une autre opération sur la ligne d'opération suivante.

Pour définir des paramètres pour une opération de service Web

  1. Dans la fenêtre Détails de service Web, développez le nœud d'opération.

  2. Sur la ligne de paramètres au-dessous de l'opération, cliquez sur < ajouter un paramètre > sous Nom et nommez le paramètre.

    Conseil :

    Choisissez un nom de paramètre unique dans l'opération.

  3. Sous Type, spécifiez le type de paramètres si nécessaire.

  4. Sous Modificateur, sélectionnez comment passer le paramètre.

  5. Sous Résumé, ajoutez les commentaires relatifs au paramètre.

    Conseil :

    Pour ajouter plus d'informations, cliquez sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Description.

Après avoir défini un paramètre, vous pouvez définir un nouveau paramètre sur la ligne de paramètres suivante. Vous pouvez également modifier un paramètre via ses propriétés dans la fenêtre Propriétés.

Voir aussi

Tâches

Comment : spécifier des opérations unidirectionnelles ou de demande-réponse pour les services Web ASP.NET

Comment : modifier des opérations pour les services Web ASP.NET

Comment : supprimer des opérations et des paramètres de services Web ASP.NET

Référence

Raccourcis clavier de la fenêtre Détails de service Web

Autres ressources

Définition d'opérations pour les services Web ASP.NET