Données mises en cache dans les personnalisations au niveau du documentCached data in document-level customizations

Des principaux objectifs des personnalisations au niveau du document sont de séparer les données à partir de la vue dans les documents Office.A primary goal of document-level customizations is to separate data from view in Office documents. Les données font référence aux informations stockées dans le document, y compris des nombres et du texte.Data refers to the information that is stored in the document, including numbers and text. Vue fait référence à l’interface utilisateur et le modèle objet de Microsoft Office Word et Microsoft Office Excel.View refers to the user interface and the object model of Microsoft Office Word and Microsoft Office 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 comme un îlot de données, également appelé le cache de données.Visual Studio separates the data from the view in document-level customizations by enabling data to be embedded as a data island, also called the data cache. Vous pouvez lire ou modifier les données directement sans démarrer Word ou Excel.You can read or modify the data directly without starting Word or Excel. Cela est utile lorsque vous avez besoin modifier des données dans des documents sur un serveur qui n’a pas de Microsoft Office est installé.This is useful when you need to modify data in documents on a server that does not have Microsoft Office installed. Word et Excel sont destinées à utiliser dans des environnements clients ; elles ne sont pas conçues pour être exécuté sur un serveur.Word and Excel are intended for use in client environments; they are not designed to be run on a server.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de niveau document pour Excel et Word.Applies to: The information in this topic applies to document-level projects for Excel and Word. Pour plus d’informations, consultez fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features available by Office application and project type.

Pour plus d’informations sur les personnalisations au niveau du document, consultez présentation du développement de solutions Office (VSTO) et Architecture des personnalisations au niveau du document.For more information about document-level customizations, see Office solutions development overview (VSTO) and Architecture of document-level customizations.

Comprendre le modèle de programmation de données mises en cacheUnderstand the cached data programming model

L’îlot de données peut contenir n’importe quel objet dans votre solution qui répond à certaines exigences.The data island can contain any object in your solution that meets certain requirements. Ces objets incluent DataSet objets, DataTable objets et tout autre objet qui peut être sérialisé par la XmlSerializer classe.These objects include DataSet objects, DataTable objects, and any other object that can be serialized by the XmlSerializer class. Pour plus d’informations, consultez mettre en Cache données.For more information, see Cache data.

Pour consulter les données mises en cache, vous pouvez lier des contrôles Windows Forms et contrôles hôtes sur le document à des objets dans l’îlot de données.To provide the view for the cached data, you can bind Windows Forms controls and host controls on the document to objects in the data island. Liaison de données entre l’îlot de données et les contrôles liés aux données conserve les deux synchronisés.Data binding between the data island and the data-bound controls keeps the two synchronized. Vous pouvez également ajouter le code de validation aux données qui est indépendantes des contrôles.You can also add validation code to the data that is independent of the controls. Pour plus d’informations, consultez lier des données aux contrôles dans les solutions Office.For more information, see Bind data to controls in Office solutions.

Contrôles hôtes sont étendus des versions d’objets natifs dans les modèles objet Excel et Word.Host controls are extended versions of native objects in the Excel and Word object models. Contrairement aux objets natifs, contrôles hôtes peuvent être liés directement aux objets de données managées.Unlike the native objects, host controls can be bound directly to managed data objects. Pour plus d’informations, consultez éléments hôtes et héberger de vue d’ensemble des contrôles et des contrôles de Windows Forms dans les documents Office.For more information, see Host items and host controls overview and Windows Forms controls on Office documents overview.

Accès mis en cache les données sur le serveurAccess cached data on the server

Pour accéder aux données mises en cache dans un document, vous pouvez utiliser la ServerDocument classe.To access cached data in a document, you can use the ServerDocument class. Cette classe fait partie de la Visual Studio Tools pour Office RuntimeVisual Studio Tools for Office runtime, et il peut être utilisé sur un serveur sans exécuter Excel ou Word.This class is part of the Visual Studio Tools pour Office RuntimeVisual Studio Tools for Office runtime, and it can be used on a server without running Excel or Word. Lorsque l’utilisateur ouvre le document une fois que vous modifiez les données mises en cache, tous les contrôles qui sont liés aux données sont automatiquement synchronisés avec les modifications, et l’utilisateur est présenté avec les données mises à jour.When the user opens the document after you modify the cached data, any controls that are bound to the data are automatically synchronized to the changes, and the user is presented with the updated data. Pour plus d’informations, consultez accéder aux données dans des documents sur le serveur.For more information, see 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 and Word are not needed to write to the data on the server, only to view it on the client. Excel et Word est même inutile être installé sur le serveur.Excel and Word do not even need to be installed on the server. Cela fournit une plus grande évolutivité et la possibilité d’effectuer le traitement rapide de lots de documents qui contiennent des îlots de données.This provides improved scalability and the ability to perform fast batch processing of documents that contain data islands.

La mise en cache pour une utilisation hors connexion de donnéesData caching for offline use

Stockage des données dans l’îlot de données permet des scénarios hors connexion.Storing data in the data island enables offline scenarios. Lorsqu’un utilisateur ouvre un document tout d’abord ou demande le document à partir du serveur, l’îlot de données est remplie avec les données les plus récentes.When a user first opens a document or requests the document from the server, the data island is filled with the most recent data. L’îlot de données est mis en cache dans le document, puis est disponible hors connexion.The data island is cached in the document and is then available offline. L’utilisateur (et votre code) peuvent manipuler les données, même si aucune connexion active n’est disponible.The user (and your code) can manipulate the data, even though no live connection is available. Lorsque l’utilisateur se reconnecte, les modifications apportées aux données peuvent être propagées à la source de données de serveur.When the user reconnects, the changes to the data can be propagated back to a server data source.

Données mises en cache et les parties XML personnalisées par rapportCached data and custom XML parts compared

Parties XML personnalisées ont été introduits dans Microsoft Office system 2007 comme un moyen de stocker des fragments XML arbitraires dans un document.Custom XML parts were introduced in the 2007 Microsoft Office system as a way to store arbitrary pieces of XML in a document. Bien que les parties XML personnalisées sont utiles dans de nombreux scénarios de cache de données, il existe certaines différences entre l’îlot de données et les parties XML personnalisées.Although custom XML parts are useful in many of the same scenarios as the data cache, there are some differences between the data island and custom XML parts. Pour plus d’informations sur les parties XML personnalisées, consultez vue d’ensemble des parties XML personnalisées.For more information about custom XML parts, see Custom XML parts overview.

Le tableau suivant répertorie certaines des différences et similitudes.The following table lists some of the differences and similarities.

Cache de donnéesData cache Parties XML personnaliséesCustom XML parts
Les applications Office peuvent les utiliser ?Which Office applications can use these? Personnalisations au niveau du document pour les applications suivantes :Document-level customizations for the following applications:

-Excel- Excel
-Word- Word
Solutions au niveau du document et de niveau application pour les applications suivantes :Document-level and application-level solutions for the following applications:

-Excel- Excel
-PowerPoint- PowerPoint
-Word- Word
Les types de données peut stocker ?What types of data can you store? Tout objet public de votre assembly de personnalisation qui répond à certaines exigences.Any public object in your customization assembly that meets certain requirements. Pour plus d’informations, consultez mettre en Cache données.For more information, see Cache data. Toutes les données XML.Any XML data.
Vous accédez aux données sans démarrer des applications Microsoft Office ?Can you access the data without starting Microsoft Office applications? Oui, à l’aide de la ServerDocument classe fournie par le Visual Studio Tools pour Office RuntimeVisual Studio Tools for Office runtime.Yes, by using the ServerDocument class provided by the Visual Studio Tools pour Office RuntimeVisual Studio Tools for Office runtime. Oui, en utilisant des classes dans le System.IO.Packaging espace de noms, ou à l’aide du SDK de Format Open XML.Yes, by using classes in the System.IO.Packaging namespace, or by using the Open XML Format SDK.

Voir aussiSee also

Données dans les solutions Office Data in Office solutions
Architecture des solutions Office dans Visual StudioArchitecture of Office solutions in Visual Studio