Gerenciar documentos em um servidor usando a classe ServerDocument
Você pode usar a ServerDocument classe no tempo de execução do Visual Studio Tools for Office para gerenciar vários aspectos de personalizações em nível de documento, mesmo se o Microsoft Office Word e o Microsoft Office Excel não estiverem instalados. Você pode executar estas tarefas:
Acessar e modificar dados no cache de dados de um documento ou pasta de trabalho. Para obter mais informações, consulte Trabalhar com dados armazenados em cache no documento.
Gerenciar o assembly de personalização associado a um documento. Para obter mais informações, consulte Gerenciar a personalização do documento.
Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento para Excel e Word. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.
Compreender a classe ServerDocument
A ServerDocument classe foi projetada para ser usada em computadores que não têm o Office instalado. Portanto, você normalmente usa essa classe em aplicativos que não se integram ao Office, como projetos de console ou projetos do Windows Forms, em vez de projetos do Office. Use a ServerDocument classe no assembly Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll
A ServerDocument classe pode ser usada para operar em personalizações de nível de documento que foram criadas usando o Visual Studio 2013.
Para obter mais informações sobre o Visual Studio 2010 Tools for Office Runtime e as extensões do Office para o .NET Framework, consulte Visão geral do tempo de execução do Visual Studio Tools for Office.
Observação
Se você tiver um aplicativo herdado que usa a ServerDocument Visual Studio Tools for Office classe no sistema (versão 3.0 Runtime), o sistema (versão 3.0 runtime) deve ser instalado em computadores que executam o Visual Studio Tools for Office aplicativo. O Visual Studio 2010 Tools for Office runtime não é possível executar esses aplicativos.
Trabalhar com dados armazenados em cache no documento
A ServerDocument classe fornece membros que você pode usar para trabalhar com o cache de dados em documentos personalizados. Para obter mais informações sobre dados armazenados em cache, consulte Dados de cache e Dados do Access em documentos no servidor.
A tabela a seguir lista os membros que você pode usar para trabalhar com dados armazenados em cache.
| Tarefa | Membro a ser usado |
|---|---|
| Para determinar se um documento tem um cache de dados. | O método IsCacheEnabled. |
| Para acessar os dados armazenados em cache em um documento. Para obter mais informações, consulte Acessar dados em documentos no servidor. |
A propriedade de CachedData . |
Gerenciar a personalização do documento
Você pode usar membros da ServerDocument classe para gerenciar o assembly de personalização associado a um documento. Por exemplo, você pode remover programaticamente a personalização de um documento para que o documento não faça mais parte de uma personalização.
A tabela a seguir lista os membros que você pode usar para gerenciar o assembly de personalização.
| Tarefa | Membro a ser usado |
|---|---|
| Para determinar se um documento faz parte de uma personalização em nível de documento. | O método GetCustomizationVersion. |
| Para anexar programaticamente uma personalização a um documento em tempo de execução. Para obter mais informações, consulte Como: Anexar extensões de código gerenciado a documentos |
Um dos AddCustomization métodos. |
| Para remover programaticamente uma personalização de um documento em tempo de execução. Para obter mais informações, consulte Como: Remover extensões de código gerenciado de documentos. |
O método RemoveCustomization. |
| Para obter a URL do manifesto de implantação associado ao documento. | A propriedade de DeploymentManifestUrl . |