Partager via


Gérer des documents sur un serveur à l’aide de la classe ServerDocument

Vous pouvez utiliser la ServerDocument classe dans Visual Studio Tools pour Office runtime pour gérer plusieurs aspects des personnalisations au niveau du document, même si Microsoft Office Word et Microsoft Office Excel ne sont pas installés. Vous pouvez effectuer les tâches suivantes :

Comprendre la classe ServerDocument

La ServerDocument classe est conçue pour être utilisée sur les ordinateurs qui n’ont pas d’office installé. Par conséquent, vous utilisez généralement cette classe dans les applications qui ne s’intègrent pas à Office, telles que les projets console ou les projets Windows Forms, plutôt que les projets Office. Utilisez la ServerDocument classe dans l’assembly Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll .

La ServerDocument classe peut être utilisée pour fonctionner sur des personnalisations au niveau du document qui ont été créées à l’aide de Visual Studio 2013.

Pour plus d’informations sur les outils Visual Studio 2010 pour Office Runtime et les extensions Office pour .NET Framework, consultez la vue d’ensemble de Visual Studio Tools pour Office Runtime.

Note

Si vous avez une application héritée qui utilise la ServerDocument classe dans le Visual Studio Tools for Office système (version 3.0 Runtime), le Visual Studio Tools for Office système (version 3.0 runtime) doit être installé sur les ordinateurs qui exécutent l’application. Le Visual Studio 2010 Tools for Office runtime ne peut pas exécuter ces applications.

Utiliser des données mises en cache dans le document

La classe ServerDocument fournit des membres de la classe que vous pouvez utiliser pour travailler avec le cache de données dans des documents personnalisés. Pour plus d’informations sur les données mises en cache, consultez Cache des données et accéder aux données dans les documents sur le serveur.

Le tableau suivant répertorie les membres que vous pouvez utiliser pour utiliser des données mises en cache.

Tâche Membre à utiliser
Pour déterminer si un document a un cache de données. Méthode IsCacheEnabled .
Pour accéder aux données mises en cache dans un document.

Pour plus d’informations, consultez Accéder aux données dans les documents sur le serveur.
La propriété CachedData.

Gérer la personnalisation du document

Vous pouvez utiliser des membres de la ServerDocument classe pour gérer l’assembly de personnalisation associé à un document. Par exemple, vous pouvez supprimer par programmation la personnalisation d’un document afin que le document ne fasse plus partie d’une personnalisation.

Le tableau suivant répertorie les membres que vous pouvez utiliser pour gérer l’assembly de personnalisation.

Tâche Membre à utiliser
Pour déterminer si un document fait partie d’une personnalisation au niveau du document. Méthode GetCustomizationVersion .
Pour attacher par programmation une personnalisation à un document au moment de l’exécution.

Pour plus d’informations, consultez Guide pratique pour attacher des extensions de code managé à des documents
Une des AddCustomization méthodes.
Pour supprimer par programmation une personnalisation d’un document au moment de l’exécution.

Pour plus d’informations, consultez How to : Remove managed code Extensions from documents.
Méthode RemoveCustomization .
Pour obtenir l’URL du manifeste de déploiement associé au document. La propriété DeploymentManifestUrl.