Comment : accéder aux paramètres utilisateur avec les services d'application cliente
Vous pouvez utiliser des services d'application cliente pour extraire des paramètres d'application utilisateur d'un service de profil Microsoft 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 Microsoft Ajax, consultez Utilisation d'informations de profil avec Microsoft 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 Microsoft 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
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.
Sur la page Paramètres du concepteur de projets, cliquez sur Charger les paramètres Web.
La boîte de dialogue Connexion s'affiche.
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.
Notes
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.
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.MySettingProperties.Settings.Default.MySetting = "test"; myLabel.Text = Properties.Settings.Default.MySetting;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
Référence
Concepts
Vue d'ensemble des services d'application cliente
Utilisation d'informations de profil avec Microsoft Ajax
Vue d'ensemble des paramètres d'application