Compartilhar via


Gerenciar documentos em um servidor usando a classe ServerDocument

Você pode usar a ServerDocument classe no runtime das Ferramentas do Visual Studio para Office para gerenciar vários aspectos das personalizações no nível do documento, mesmo se o Microsoft Office Word e o Microsoft Office Excel não estiverem instalados. Você pode executar estas tarefas:

Entender a classe ServerDocument

A ServerDocument classe foi projetada para ser usada em computadores que não têm o Office instalado. Portanto, normalmente você 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 classe ServerDocument 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 as Ferramentas do Visual Studio 2010 para Office Runtime e as extensões do Office para o .NET Framework, consulte a visão geral das Ferramentas do Visual Studio para Office.

Observação

Se você tiver um aplicativo herdado que usa a ServerDocument classe no Visual Studio Tools for Office sistema (versão 3.0 Runtime), o Visual Studio Tools for Office sistema (runtime da versão 3.0) deverá ser instalado em computadores que executam o aplicativo. Visual Studio 2010 Tools for Office runtime não pode 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 do 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 Elemento a ser utilizado
Para determinar se um documento tem um cache de dados. O IsCacheEnabled método .
Para acessar os dados armazenados em cache em um documento.

Para obter mais informações, consulte Acessar dados em documentos no servidor.
A CachedData propriedade.

Gerenciar a personalização do documento

Você pode usar membros da classe ServerDocument 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 Elemento a ser utilizado
Para determinar se um documento faz parte de uma personalização no nível do documento. O GetCustomizationVersion método .
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 RemoveCustomization método .
Para obter a URL do manifesto de implantação associado ao documento. A DeploymentManifestUrl propriedade.