Configurer la référence de service, boîte de dialogue
Date de publication : juin 2016
La boîte de dialogue Configurer la référence de service vous permet de configurer le comportement des services Windows Communication Foundation (WCF).
Notes
Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Customizing Development Settings in Visual Studio.
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 Add Service Reference Dialog Box.
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 et sélectionnez les références souhaitées dans la Liste des assemblys référencés.
Liste UIElement
Address
Permet de mettre à jour l'adresse web qu'une référence de service utilise pour rechercher 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 Add Service Reference Dialog Box.
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, voir Troubleshooting Service References.
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 les opérations basées sur la tâche
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. Voir Bibliothèque parallèle de tâches.
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, voir 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. Quand l'option Réutiliser les types dans les assemblys référencés spécifiés est cochée, il est possible de sélectionner ou de désélectionner des assemblys individuels.
Ajouter une référence web
Affiche la NIB: Add Web Reference Dialog Box.
Notes
Cette option doit uniquement être utilisée pour les projets qui ciblent la version 2.0 du .NET Framework.
Notes
Le bouton Ajouter une référence web est uniquement disponible quand la boîte de dialogue Configurer la référence de service est affichée à partir de la Add Service Reference Dialog Box.
Voir aussi
Add Service Reference Dialog Box
How to: Add, Update, or Remove a Service Reference
How to: Add a Reference to a Web Service
Services Windows Communication Foundation et services de données WCF
Consommation de services ASMX et WCF, exemple