Comment : mettre en cache des données pour une utilisation hors connexion ou sur un serveur

Mise à jour : novembre 2007

Vous pouvez marquer un élément de données à mettre en cache dans le document, afin qu'il soit disponible hors connexion. Cela permet également la manipulation des données du document par un autre code lorsque le document est stocké sur un serveur.

Vous pouvez marquer un élément de données à mettre en cache lorsque cet élément est déclaré dans votre code, ou, si vous utilisez DataSet, en définissant une propriété dans la fenêtre Propriétés. Si vous mettez en cache un élément de données qui n'est pas DataSet ni DataTable, assurez-vous qu'il réponde aux critères de mise en cache dans le document. Pour plus d'informations, consultez Mise en cache des données.

Remarque :

Les groupes de données créés à l'aide de Visual Basic et marqués comme Cached et WithEvents (notamment les groupes de données déplacés à partir de la fenêtre Sources de données ou de la Boîte à outils et dont la propriété CacheInDocument a la valeur True) ont un trait de soulignement comme préfixe à leur nom dans le cache. Par exemple, si vous créez un groupe de données et lui attribuez le nom Clients, le nom CachedDataItem sera _Clients dans le cache. Lorsque vous utilisez ServerDocument pour accéder à cet élément mis en cache, vous devez spécifier _Clients au lieu de Clients.

Pour mettre en cache des données dans le document à l'aide du code

1. Déclarez un champ public ou une propriété publique pour l'élément de données en tant que membre d'une classe d'élément hôte dans votre projet, tel que la classe ThisDocument dans un projet Word ou la classe ThisWorkbook dans un projet Excel.

2. Appliquez l'attribut CachedAttribute au membre pour marquer l'élément de données à stocker dans le cache de données du document. L'exemple suivant applique cet attribut à une déclaration de champ pour DataSet.

   <Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()> _
   Public employeesDataSet As DataSet
   

   [Microsoft.VisualStudio.Tools.Applications.Runtime.Cached()]
   public DataSet employeesDataSet;
   

3. Ajoutez du code pour créer une instance de l'élément de données et, le cas échéant, la charger à partir de la base de données.

   L'élément de données est uniquement chargé lors de sa création initiale ; ensuite, le cache est conservé avec le document et vous devez écrire un autre code pour le mettre à jour.

Pour mettre en cache un groupe de données dans le document à l'aide de la fenêtre Propriétés

1. Ajoutez le groupe de données au projet à l'aide des outils dans le concepteur Visual Studio, par exemple, en ajoutant une source de données à votre projet à l'aide de la fenêtre Sources de données.

2. Créez une instance du groupe de données si vous n'en possédez pas déjà une, et sélectionnez l'instance dans le concepteur.

3. Dans la fenêtre Propriétés, affectez à la propriété CacheInDocument la valeur True.

   Pour plus d'informations, consultez Propriétés des projets Visual Studio Tools pour Office.

4. Dans la fenêtre Propriétés, affectez la valeur Public à la propriété Modifiers (la valeur par défaut est Internal).

Voir aussi

Tâches

Comment : mettre en cache par programme une source de données dans un document Office

Comment : arrêter par programme la mise en cache d'une source de données

Comment : mettre en cache des données dans un document protégé par un mot de passe

Concepts

Mise en cache des données

Accès aux données des documents sur le serveur

Autres ressources

Enregistrement des données

Contrôle d'accès concurrentiel dans ADO.NET