Gérer des documents sur un serveur à l’aide de la classe ServerDocument
Vous pouvez utiliser la ServerDocument classe dans le runtime Visual Studio Tools pour Office pour gérer plusieurs aspects des personnalisations au niveau du document, même si Microsoft Bureau Word et Microsoft Bureau Excel ne sont pas installés. Vous pouvez effectuer les tâches suivantes :
Accéder aux données et les modifier dans le cache de données d’un document ou d’un classeur. Pour plus d’informations, consultez Utiliser des données mises en cache dans le document.
Gérez l’assembly de personnalisation associé à un document. Pour plus d’informations, consultez Gérer la personnalisation du document.
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.
Comprendre la classe ServerDocument
La ServerDocument classe est conçue pour être utilisée sur les ordinateurs qui n’ont pas Bureau installés. Par conséquent, vous utilisez généralement cette classe dans les applications qui ne s’intègrent pas à Bureau, comme les projets console ou les projets Windows Forms, plutôt que les projets Bureau. 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 visual Studio 2010 Tools for Bureau Runtime et les extensions Bureau pour .NET Framework, consultez Visual Studio Tools pour Office vue d’ensemble du runtime.
Remarque
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. Impossible Visual Studio 2010 Tools for Office runtime d’exécuter ces applications.
Utiliser des données mises en cache dans le document
La ServerDocument classe fournit aux membres que vous pouvez utiliser pour utiliser 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 Access data in documents on the server. |
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. |