Comment : travailler hors connexion avec les services d'application cliente

Vous pouvez utiliser les services d'application cliente en mode hors connexion lorsque les services d'application d'Microsoft Ajax auxquels votre application se connecte ne sont pas disponibles. Cela vous permet d'authentifier des utilisateurs, d'extraire des rôles d'utilisateur et d'extraire ou d'enregistrer les paramètres Web de l'utilisateur à l'aide d'un cache de données local. En mode hors connexion, toutes les requêtes de service vont automatiquement au cache local sans que des modifications soient requises pour votre code.

L'état hors connexion est stocké sur le disque dur local à l'emplacement indiqué par la propriété Application.UserAppDataPath. Cela signifie que l'état hors connexion est stocké sur une base individuelle, pour chaque application. Lorsque votre application est en mode hors connexion, tous les appels qui seraient normalement allés au service distant accèdent au cache de données local. Par défaut, les valeurs hors connexion sont stockées sur le système de fichiers local. Vous pouvez également configurer votre application de sorte qu'elle utilise une base de données SQL Server ou SQL Server Compact Edition version 3.5. Pour plus d'informations, consultez Comment : configurer les services d'application cliente.

La procédure suivante décrit comment passer votre application en mode hors connexion lorsque celle-ci est configurée pour utiliser les services d'application cliente. 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 placer votre application en mode hors connexion

1. Vérifiez que votre application est correctement configurée pour utiliser les services d'application cliente en mode hors connexion, comme décrit dans Comment : configurer les services d'application cliente. Vous sélectionnez généralement l'option Enregistrer le hachage de mot de passe localement pour activer la connexion hors connexion, ce qui vous permet d'authentifier les utilisateurs pendant que l'application est hors connexion. En outre, vous souhaitez peut-être affecter à l'option Dépassement du délai de cache du service de rôle une valeur plus élevée pour empêcher l'expiration des informations de rôle en mode hors connexion.

2. Affectez à la propriété static ConnectivityStatus.IsOffline la valeur true. L'exemple de code suivant illustre la définition de cette propriété dans un gestionnaire d'événements CheckBox.CheckedChanged afin que l'utilisateur puisse passer en mode hors connexion ou en ligne.

   Private Sub checkBox1_CheckedChanged( _
       ByVal sender As Object, ByVal e As EventArgs) _
       Handles checkBox1.CheckedChanged
   
       ConnectivityStatus.IsOffline = checkBox1.Checked
   
   End Sub
   

   private void checkBox1_CheckedChanged(object sender, EventArgs e)
   {
       ConnectivityStatus.IsOffline = checkBox1.Checked;
   }
   

Programmation fiable

L'exemple de code dans cette rubrique montre l'utilisation la plus simple du mode hors connexion dans une application cliente Windows. Vous souhaitez peut-être ajouter du code supplémentaire qui s'exécute lorsque votre application repasse en mode en ligne. Par exemple, vous pouvez revalider silencieusement l'utilisateur pour garantir que les appels de service distant n'échoueront pas à cause d'un cookie d'authentification expiré. En outre, vous pouvez mettre à jour le cache des paramètres Web locaux et le service de paramètres Web distant avec toutes les modifications apportées en mode hors connexion. Pour obtenir un exemple de code qui illustre ces comportements, 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

Référence

ConnectivityStatus.IsOffline

Concepts

Vue d'ensemble des services d'application cliente

Autres ressources

Services d'application cliente