Partager via


Données mises en cache dans les personnalisations au niveau du document

L’objectif principal des personnalisations au niveau du document est de séparer les données d’une vue dans Bureau documents. Les données font référence aux informations stockées dans le document, y compris les nombres et le texte. L’affichage fait référence à l’interface utilisateur et au modèle objet de Microsoft Bureau Word et Microsoft Bureau Excel.

Visual Studio sépare les données de la vue dans les personnalisations au niveau du document en permettant aux données d’être incorporées en tant qu’île de données, également appelée cache de données. Vous pouvez lire ou modifier les données directement sans démarrer Word ou Excel. Cela est utile lorsque vous devez modifier des données dans des documents sur un serveur sur lequel Microsoft n’est pas installé Bureau. Word et Excel sont destinés à être utilisés dans les environnements clients ; ils ne sont pas conçus pour être exécutés 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.

Pour plus d’informations sur les personnalisations au niveau du document, consultez Bureau vue d’ensemble du développement de solutions (VSTO) et Architecture des personnalisations au niveau du document.

Comprendre le modèle de programmation de données mis en cache

L’île de données peut contenir n’importe quel objet dans votre solution qui répond à certaines exigences. Ces objets incluent des DataSet objets, DataTable des objets et tout autre objet qui peut être sérialisé par la XmlSerializer classe. Pour plus d’informations, consultez Les données du cache.

Pour fournir l’affichage des données mises en cache, vous pouvez lier des contrôles Windows Forms et héberger des contrôles sur le document aux objets de l’île de données. La liaison de données entre l’île de données et les contrôles liés aux données conserve les deux synchronisées. Vous pouvez également ajouter du code de validation aux données indépendantes des contrôles. Pour plus d’informations, consultez Lier des données aux contrôles dans Bureau solutions.

Les contrôles hôtes sont des versions étendues d’objets natifs dans les modèles objet Excel et Word. Contrairement aux objets natifs, les contrôles hôtes peuvent être liés directement aux objets de données managés. Pour plus d’informations, consultez la vue d’ensemble des éléments hôtes et des contrôles hôtes et des contrôles Windows Forms sur Bureau vue d’ensemble des documents.

Accéder aux données mises en cache sur le serveur

Pour accéder aux données mises en cache dans un document, vous pouvez utiliser la ServerDocument classe. Cette classe fait partie du runtime Visual Studio Tools pour Office et peut être utilisée sur un serveur sans exécuter Excel ou Word. Lorsque l’utilisateur ouvre le document après avoir modifié les données mises en cache, tous les contrôles liés aux données sont automatiquement synchronisés avec les modifications et l’utilisateur est présenté avec les données mises à jour. Pour plus d’informations, consultez Access data in documents on the server.

Excel et Word ne sont pas nécessaires pour écrire dans les données sur le serveur, uniquement pour l’afficher sur le client. Excel et Word n’ont même pas besoin d’être installés sur le serveur. Cela offre une scalabilité améliorée et la possibilité d’effectuer un traitement par lots rapide de documents qui contiennent des îles de données.

Mise en cache des données pour une utilisation hors connexion

Le stockage de données dans l’île de données permet des scénarios hors connexion. Lorsqu’un utilisateur ouvre d’abord un document ou demande le document à partir du serveur, l’île de données est remplie avec les données les plus récentes. L’île de données est mise en cache dans le document et est ensuite disponible hors connexion. L’utilisateur (et votre code) peut manipuler les données, même si aucune connexion active n’est disponible. Lorsque l’utilisateur se reconnecte, les modifications apportées aux données peuvent être propagées vers une source de données serveur.

Données mises en cache et parties XML personnalisées comparées

Les parties XML personnalisées ont été introduites dans le système Microsoft Bureau 2007 pour stocker des éléments XML arbitraires dans un document. Bien que les parties XML personnalisées soient utiles dans de nombreux scénarios identiques au cache de données, il existe des différences entre l’île de données et les parties XML personnalisées. Pour plus d’informations sur les composants XML personnalisés, consultez la vue d’ensemble des composants XML personnalisés.

Le tableau suivant répertorie certaines différences et similitudes.

Question /Caractéristique Cache de données Parties XML personnalisées
Quelles application Office lications peuvent utiliser ? Personnalisations au niveau du document pour les applications suivantes :

-Excel
-Mot
Solutions au niveau du document et au niveau de l’application pour les applications suivantes :

-Excel
-Powerpoint
-Mot
Quels types de données pouvez-vous stocker ? Tout objet public dans votre assembly de personnalisation qui répond à certaines exigences. Pour plus d’informations, consultez Les données du cache. Toutes les données XML.
Pouvez-vous accéder aux données sans démarrer Microsoft application Office lications ? Oui, à l’aide de la ServerDocument classe fournie par le runtime Visual Studio Tools pour Office. Oui, à l’aide de classes dans l’espace System.IO.Packaging de noms ou à l’aide du Kit de développement logiciel (SDK) au format Open XML.