Partager via

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. Les données du document peuvent ainsi être manipulées par d’autres codes lorsque le document est stocké sur un serveur.

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

Vous pouvez marquer un élément de données à mettre en cache lorsqu’il 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 un DataTable, assurez-vous qu’il répond aux critères de mise en cache dans le document. Pour plus d’informations, consultez Données de 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 de la Boîte à outils, dont la propriété CacheInDocument a la valeur True) sont précédés d’un trait de soulignement dans le cache. Par exemple, si vous créez un jeu de données et que vous le nommez Clients, le CachedDataItem nom 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.

Mettre en cache des données dans le document à l’aide d’un code

  1. Déclarez un champ 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, telle 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 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 création. Ensuite, le cache reste avec le document et vous devez écrire un autre code pour le mettre à jour.

Mettre en cache un jeu de données dans le document à l’aide de la fenêtre « Propriétés »

  1. Ajoutez le jeu de données au projet à l’aide des outils disponible 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, attribuez à la propriété CacheInDocument la valeur True.

    Pour en savoir plus, consultez Properties in Office Projects.

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

Contenu connexe