Administrar documentos en un servidor mediante la clase ServerDocument
Puede usar la ServerDocument clase en el entorno de ejecución de Visual Studio Tools para Office para administrar varios aspectos de las personalizaciones de nivel de documento, incluso si Microsoft Office Word y Microsoft Office Excel no están instalados. Puede realizar las siguientes tareas:
Acceder a los datos y modificarlos en la memoria caché de datos de un documento o libro. Para obtener más información, vea Trabajar con datos almacenados en caché en el documento.
Administre el ensamblado de personalización asociado a un documento. Para obtener más información, consulte Administrar la personalización del documento.
Se aplica a: la información de este tema se aplica a proyectos de nivel de documento para Excel y Word. Para obtener más información, consulte Características disponibles por aplicación de Office lication y tipo de proyecto.
Descripción de la clase ServerDocument
La ServerDocument clase está diseñada para usarse en equipos que no tienen Instalado Office. Por lo tanto, normalmente se usa esta clase en aplicaciones que no se integran con Office, como proyectos de consola o proyectos de Windows Forms, en lugar de proyectos de Office. Use la ServerDocument clase en el ensamblado Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll .
La ServerDocument clase se puede usar para operar en personalizaciones de nivel de documento creadas mediante Visual Studio 2013.
Para obtener más información sobre Visual Studio 2010 Tools para Office Runtime y las extensiones de Office para .NET Framework, consulte Visual Studio Tools para Office información general del entorno de ejecución.
Nota:
Si tiene una aplicación heredada que usa la ServerDocument clase en el Visual Studio Tools for Office sistema (versión 3.0 Runtime), el Visual Studio Tools for Office sistema (versión 3.0 runtime) debe instalarse en los equipos que ejecutan la aplicación. No Visual Studio 2010 Tools for Office runtime se pueden ejecutar estas aplicaciones.
Trabajar con datos almacenados en caché en el documento
La ServerDocument clase proporciona miembros que puede usar para trabajar con la caché de datos en documentos personalizados. Para obtener más información sobre los datos almacenados en caché, consulte Almacenamiento en caché y Acceso a datos en documentos en el servidor.
En la tabla siguiente se enumeran los miembros que puede usar para trabajar con datos almacenados en caché.
| Tarea | Miembro para usar |
|---|---|
| Para determinar si un documento tiene una caché de datos. | El método IsCacheEnabled . |
| Para acceder a los datos almacenados en caché en un documento. Para obtener más información, consulte Acceso a datos en documentos en el servidor. |
Propiedad CachedData |
Administrar la personalización del documento
Puede usar miembros de la ServerDocument clase para administrar el ensamblado de personalización asociado a un documento. Por ejemplo, puede quitar mediante programación la personalización de un documento para que el documento ya no forme parte de una personalización.
En la tabla siguiente se enumeran los miembros que puede usar para administrar el ensamblado de personalización.
| Tarea | Miembro para usar |
|---|---|
| Para determinar si un documento forma parte de una personalización de nivel de documento. | El método GetCustomizationVersion . |
| Para adjuntar mediante programación una personalización a un documento en tiempo de ejecución. Para obtener más información, consulte How to: Attach managed code extensions to documents (Cómo: Adjuntar extensiones de código administrado a documentos). |
Uno de los AddCustomization métodos. |
| Para quitar mediante programación una personalización de un documento en tiempo de ejecución. Para obtener más información, vea Cómo: Quitar extensiones de código administrado de documentos. |
El método RemoveCustomization . |
| Para obtener la dirección URL del manifiesto de implementación asociado al documento. | Propiedad DeploymentManifestUrl |