Configurer la référence de service (boîte de dialogue)

  • Article

Remarque

Les jeux de données et les classes associées sont des technologies .NET Framework héritées qui datent du début des années 2000. Elles permettent aux applications d’utiliser des données en mémoire pendant que les applications sont déconnectées de la base de données. Elles sont particulièrement utiles aux applications qui permettent aux utilisateurs de modifier des données, et de rendre ces changements persistants dans la base de données. Même si les jeux de données sont une technologie très efficace, nous vous recommandons d’utiliser Entity Framework Core pour les nouvelles applications .NET. Entity Framework offre un moyen plus naturel d’utiliser des données tabulaires en tant que modèles objet. De plus, il présente une interface de programmation plus simple.

La boîte de dialogue Configurer la référence du service vous permet de configurer le comportement des services Windows Communication Foundation (WCF).

Pour accéder à la boîte de dialogue Configurer la référence de service, cliquez avec le bouton droit sur une référence de service dans l’Explorateur de solutions et choisissez Configurer la référence de service. Vous pouvez également accéder à la boîte de dialogue en cliquant sur le bouton Avancé dans la boîte de dialogue Ajouter une référence de service.

Liste des tâches

  • Pour modifier l’adresse d’hébergement d’un service WCF, entrez la nouvelle adresse dans le champ Adresse.

  • Pour modifier le niveau d’accès des classes dans un client WCF, sélectionnez un mot clé de niveau d’accès dans la liste Niveau d’accès pour les classes générées.

  • Pour appeler de façon asynchrone les méthodes d’un service WCF, cochez la case Générer des opérations asynchrones.

  • Pour générer des types de contrats de message dans un client WCF, cochez la case Toujours générer des contrats de message.

  • Pour spécifier des types de collections de dictionnaires ou de listes pour un client WCF, sélectionnez les types dans les listes Type de collection et Type de collection Dictionnaire.

  • Pour désactiver le partage de type, décochez la case Réutiliser les types dans les assemblys référencés. Pour activer le partage de type d’un sous-ensemble d’assemblys référencés, cochez la case Réutiliser les types dans les assemblys référencés, sélectionnez Réutiliser les types dans les assemblys référencés spécifiés, puis sélectionnez les références souhaitées dans la Liste des assemblys référencés.

Liste des éléments de l'interface utilisateur

Adresse

Met à jour l’adresse web où une référence de service recherche un service. Par exemple, pendant le développement, le service peut être hébergé sur un serveur de développement, puis transféré ultérieurement vers un serveur de production, ce qui nécessite un changement d'adresse.

Notes

L’élément Adresse n’est pas disponible quand la boîte de dialogue Configurer la référence de service est affichée à partir de la boîte de dialogue Ajouter une référence de service.

Niveau d’accès pour les classes générées

Détermine le niveau d'accès du code pour les classes clientes WCF.

Notes

Pour les projets de site web, cette option a toujours la valeur Public et ne peut pas être modifiée. Pour plus d’informations, consultez Dépannage des références de service.

Générer des opérations asynchrones

Détermine si les méthodes de service WCF sont appelées de façon synchrone (valeur par défaut) ou de façon asynchrone.

Générer des opérations basées sur les tâches

Dans le cadre de l’écriture de code asynchrone, cette option vous permet d’exploiter la bibliothèque parallèle de tâches (TPL) introduite dans .NET 4. Consultez Bibliothèque parallèle de tâches (TPL).

Toujours générer des contrats de message

Détermine si des types de contrats de message sont générés pour un client WCF. Pour plus d’informations sur les contrats de message, consultez Utilisation de contrats de message.

Type de collection

Spécifie le type de collection de listes pour un client WCF. Le type par défaut est Array.

Type de collection Dictionnaire

Spécifie le type de collection de dictionnaires pour un client WCF. Le type par défaut est Dictionary<TKey,TValue>.

Réutiliser les types dans les assemblys référencés

Détermine si un client WCF essaie de réutiliser ce qui existe déjà dans les assemblys référencés au lieu de générer de nouveaux types quand un service est ajouté ou mis à jour. Cette option est cochée par défaut.

Réutiliser les types dans tous les assemblys référencés

Quand cette option est cochée, tous les types indiqués dans la Liste des assemblys référencés sont réutilisés dans la mesure du possible. Cette option est activée par défaut.

Réutiliser les types dans les assemblys référencés spécifiés

Quand cette option est cochée, seuls les types sélectionnés dans la Liste des assemblys référencés sont réutilisés.

Liste des assemblys référencés

Contient la liste des assemblys référencés pour le projet ou le site web. Lorsque vous sélectionnez Réutiliser des types dans des assemblys référencés spécifiés, vous pouvez sélectionner ou effacer des assemblys individuels.

Ajouter une référence web

Affiche la boîte de dialogue Ajouter une référence web.

Notes

Cette option ne doit être utilisée que pour les projets qui ciblent la version 2.0 du .NET Framework.

Notes

Le bouton Ajouter une référence web n’est disponible que lorsque la boîte de dialogue Configurer la référence de service s’affiche à partir de la boîte de dialogue Ajouter une référence de service.

Voir aussi