Comment : accéder aux paramètres utilisateur avec les services d'application cliente

Mise à jour : novembre 2007

Vous pouvez utiliser des services d'application cliente pour extraire des paramètres d'application utilisateur d'un service de profil ASP.NET AJAX existant. La fonctionnalité des paramètres Web des services d'application cliente est intégrée à la fonctionnalité des paramètres d'application fournie dans .NET Framework 2.0. Pour plus d'informations sur les paramètres d'application, consultez Vue d'ensemble des paramètres d'application. Pour plus d'informations sur l'installation du service de profil ASP.NET AJAX, consultez Utilisation d'informations de profil avec ASP.NET AJAX.

La procédure suivante décrit comment accéder aux paramètres Web lorsque votre application est configurée pour utiliser le service de paramètres Web. Pour plus d'informations, consultez Comment : configurer les services d'application cliente. Cette procédure requiert l'accès à un service de profil ASP.NET AJAX en cours d'exécution. Pour obtenir des instructions sur le test complet des fonctionnalités des services d'application cliente, consultez Procédure pas à pas : utilisation des services d'application cliente.

Pour accéder aux paramètres Web dans votre application cliente Windows

1. Vérifiez que votre application est correctement configurée pour utiliser des services d'application cliente, comme décrit dans Comment : configurer les services d'application cliente. Vous devez au moins spécifier un emplacement de service de paramètres Web sur la page Services du concepteur de projets. Pour extraire des paramètres Web configurés en vue d'une utilisation par les utilisateurs authentifiés, vous devez également spécifier un emplacement de service d'authentification ou utiliser l'authentification Windows.

2. Sur la page Paramètres du concepteur de projets, cliquez sur Charger les paramètres Web.

   La boîte de dialogue Connexion s'affiche.

3. Pour extraire des paramètres configurés sur le serveur en vue d'une utilisation par tous les utilisateurs authentifiés, spécifiez des informations d'identification utilisateur valides et cliquez sur Se connecter. Pour extraire des paramètres configurés en vue d'une utilisation par tous les utilisateurs anonymes, cliquez sur Ignorer la connexion.

   Les paramètres configurés sur le serveur apparaissent dans le concepteur. En outre, une classe Settings (accessible en tant que Properties.Settings.Default en C# et My.Settings en Visual Basic) est générée ou mise à jour pour inclure des propriétés basées sur les paramètres. Cette classe gère toutes les interactions avec le service de paramètres Web distant via la classe ClientSettingsProvider. Bien que vous puissiez accéder directement à la classe ClientSettingsProvider, vous y accédez généralement de manière indirecte via la classe Settings, comme indiqué dans l'étape suivante. Pour plus d'informations, consultez Vue d'ensemble des services d'application cliente.

   Remarque :

   Vous ne pouvez pas utiliser la page Paramètres pour modifier les valeurs de paramètres Web par défaut ou accéder aux valeurs non définies par défaut. En outre, si les valeurs par défaut sont modifiées sur le serveur, vous devez extraire les nouvelles valeurs par défaut en cliquant sur le bouton Charger les paramètres Web. Le bouton Synchroniser n'est pas utilisé par les services d'application cliente.

4. Dans votre code d'application, utilisez les propriétés de la classe générée pour obtenir ou définir les valeurs de paramètres Web.

   L'exemple de code suivant suppose que vous avez extrait un paramètre nommé MySetting et que votre application contient un Label nommé myLabel.

   My.Settings.MySetting = "test"
   myLabel.Text = My.Settings.MySetting
   

   Properties.Settings.Default.MySetting = "test";
   myLabel.Text = Properties.Settings.Default.MySetting;
   

5. Dans votre code d'application, utilisez la méthode ApplicationSettingsBase.Save pour enregistrer les valeurs de paramètres modifiées dans le service de paramètres Web.

   My.Settings.Save()
   

   Properties.Settings.Default.Save();
   

Programmation fiable

L'exemple de code dans cette rubrique montre l'utilisation la plus simple des paramètres Web dans une application cliente Windows. Toutefois, lorsque vous utilisez ou enregistrez des paramètres Web via les services d'application cliente, votre code peut lever une WebException. Cela indique que le service n'est pas disponible ou que la connexion de l'utilisateur a expiré. Pour obtenir un exemple de gestion d'une WebException dans ces cas, consultez Procédure pas à pas : utilisation des services d'application cliente.

Voir aussi

Tâches

Comment : configurer les services d'application cliente

Procédure pas à pas : utilisation des services d'application cliente

Comment : créer des paramètres d'application

Concepts

Vue d'ensemble des services d'application cliente

Utilisation d'informations de profil avec ASP.NET AJAX

Vue d'ensemble des paramètres d'application

Référence

ClientSettingsProvider

ApplicationSettingsBase

ApplicationSettingsBase.Save

Autres ressources

Services d'application cliente

Gestion des paramètres de l'application