Configurer la référence de service (boîte de dialogue)
Remarque
Les jeux de données et les classes associées sont des technologies .NET Framework héritées du début des années 2000 qui 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. Les technologies sont particulièrement utiles pour les applications qui permettent aux utilisateurs de modifier les données et de conserver les modifications apportées à la base de données. Bien que les jeux de données soient une technologie très réussie, nous recommandons que les nouvelles applications .NET utilisent Entity Framework Core. Entity Framework offre un moyen plus naturel d’utiliser des données tabulaires en tant que modèles objet et offre 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 du service, cliquez avec le bouton droit sur une référence de service dans Explorateur de solutions et choisissez Configurer la référence du 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 où un service WCF est hébergé, 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 les méthodes d’un service WCF de façon asynchrone, 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 les types de collections de liste ou de dictionnaire pour un client WCF, sélectionnez les types dans les listes Type de collection et Type de collection de dictionnaire.
Pour désactiver le partage de types, décochez la case Réutiliser les types dans les assemblages référencés. Pour activer le partage de types pour 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 UIElement
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 déplacé ultérieurement vers un serveur de production, nécessitant une modification d’adresse.
Remarque
L’élément Address n’est pas disponible 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.
Niveau d’accès pour les classes générées
Détermine le niveau d’accès au code pour les classes clientes WCF.
Remarque
Pour les projets de site web, cette option est toujours définie sur 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 asynchrone.
Générer des opérations basées sur des tâches
Lors de l’écriture de code asynchrone, cette option vous permet de tirer parti de la bibliothèque parallèle de tâches (TPL) introduite avec .NET 4. Consultez Bibliothèque parallèle de tâches (TPL).
Toujours générer des contrats de message
Détermine si les types de contrat de message sont générés pour un client WCF. Pour plus d’informations sur les contrats de messages, 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 dictionnaire 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 tente de réutiliser ce qui existe déjà dans les assemblys référencés au lieu de générer de nouveaux types lorsqu’un service est ajouté ou mis à jour. Par défaut, cette option est cochée.
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. Par défaut, cette option est sélectionnée.
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.
Remarque
Cette option ne doit être utilisée que pour les projets qui ciblent la version 2.0 du .NET Framework.
Remarque
Le bouton Ajouter une référence web n’est disponible que lorsque la boîte de dialogue Configurer la référence du service s’affiche à partir de la boîte de dialogue Ajouter une référence de service.