Mettre en cache des données pour une utilisation hors connexion ou sur un serveur

  • Article

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 de manipuler les données du document par d’autres codes lorsque le document est stocké sur un serveur.

S’applique à : les informations contenues dans cette rubrique s’appliquent aux projets au niveau du document pour Excel et Word. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.

Vous pouvez marquer un élément de données à mettre en cache lorsque l’élément de données est déclaré dans votre code ou, si vous utilisez un 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 un DataSet ou DataTable, assurez-vous qu’il répond aux critères de mise en cache dans le document. Pour plus d’informations, consultez Les données du cache.

Remarque

Les jeux de données créés à l’aide de Visual Basic marqués comme mis en cache et WithEvents (y compris les jeux de données qui sont déplacés à partir de la fenêtre Sources de données ou boîte à outils dont la propriété CacheInDocument a la valeur True) ont un trait de soulignement précédé de leurs noms dans le cache. Par exemple, si vous créez un jeu de données et nommez-le Clients, le CachedDataItem nom sera _Customers dans le cache. Lorsque vous utilisez ServerDocument pour accéder à cet élément mis en cache, vous devez spécifier _Customers au lieu des 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é pour l’élément de données en tant que membre d’une classe d’élément hôte dans votre projet, comme la ThisDocumenclasse t dans un projet Word ou la ThisWorkbook classe 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 un 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, pour le charger à partir de la base de données.

    L’élément de données est chargé uniquement lors de sa première création ; par la suite, le cache reste avec le document et vous devez écrire d’autres codes pour le mettre à jour.

Pour mettre en cache un jeu de données dans le document à l’aide du Fenêtre Propriétés

  1. Ajoutez le jeu de données au projet à l’aide d’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 jeu de données si vous n’en avez pas déjà, puis sélectionnez l’instance dans le concepteur.

  3. Dans la fenêtre Propriétés , définissez la propriété CacheInDocument sur True.

    Pour plus d’informations, consultez Propriétés dans Bureau Projets.

  4. Dans la fenêtre Propriétés , définissez la propriété Modificateurs sur Public (par défaut, elle est Interne).

Contenu connexe