Compartilhar via

Gerenciamento de documentos em um servidor usando a classe ServerDocument

  • Artigo

Você pode usar o ServerDocument classe na Visual Studio Tools for Office runtime para gerenciar vários aspectos de personalizações em nível de documento, mesmo que Microsoft Office o Word e Excel de Microsoft Office não estão instalados. Você pode executar as seguintes tarefas:

  • Acessar e modificar dados no cache de dados de um documento ou pasta de trabalho. Para obter mais informações, consulte Trabalhando com em cache dados no documento.

  • Gerencie o assembly de personalização que está associado um documento. Para obter mais informações, consulte Gerenciando a personalização do documento.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento para os seguintes aplicativos: Excel 2007 e Excel 2010; Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Noções básicas sobre a classe ServerDocument

O ServerDocument classe é projetado para ser usado em computadores que não têm o Office instalado. Portanto, você geralmente usa essa classe em aplicativos que não integram com o Office, como, por exemplo, projetos de Console ou projetos Windows Forms, em vez de projetos do Office.

Existem duas versões diferentes da ServerDocument classe na Visual Studio 2010 Tools for Office Runtime. A versão que você deve usar depende do destino.NET Framework do aplicativo no qual você deseja usar a classe:

  • Para aplicativos que se destinam a .NET Framework 4, use o Microsoft.VisualStudio.Tools.Applications.ServerDocument classe no assembly Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll. 

  • Para aplicativos que visam o.NET Framework 3.5, use o Microsoft.VisualStudio.Tools.Applications.ServerDocument classe no assembly Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll.

Ambas as versões da ServerDocument classe pode ser usada para operar em personalizações em nível de documento que foram criadas usando Visual Studio 2010, ou no nível do documento personalizações para o Excel 2007 e Word 2007 que foram criadas usando o Visual Studio de 2008.

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 Visual Studio Tools for Office visão geral sobre o tempo de execução.

ObservaçãoObservação

Se você tiver um aplicativo herdado que usa o ServerDocument classe na Visual Studio Tools for Office system (versão 3.0 Runtime), o Visual Studio Tools for Office system (versão 3.0 Runtime) deve ser instalado em computadores que executam o aplicativo. O Visual Studio 2010 Tools for Office Runtime não pode executar esses aplicativos.

Trabalhando com dados armazenados em cache no documento

O ServerDocument classe fornece a membros, você pode usar para trabalhar com o cache de dados em documentos personalizados. Para obter mais informações sobre dados armazenados em cache, consulte Cache de dados e Acesso a dados em documentos no servidor.

A tabela a seguir lista os membros que você pode usar para trabalhar com dados em cache.

Task

Membro usar

Para determinar se um documento possui um cache de dados.

The IsCacheEnabled method.

Para acessar os dados em cache em um documento.

For more information, see Acesso a dados em documentos no servidor.

The CachedData property.

Gerenciando a personalização do documento

Você pode usar os membros da ServerDocument classe para gerenciar o assembly de personalização que está associado um documento. Por exemplo, você pode remover programaticamente a personalização de um documento para que o documento não seja parte de uma personalização.

A tabela a seguir lista os membros que você pode usar para gerenciar o assembly de personalização.

Task

Membro usar

Para determinar se um documento é parte de uma personalização em nível de documento.

The GetCustomizationVersion method.

Para anexar programaticamente uma personalização para um documento em tempo de execução.

For more information, see Como: Anexar extensões de código gerenciado aos documentos

Dentre as AddCustomization métodos.

Para remover programaticamente uma personalização de um documento em tempo de execução.

For more information, see Como: Remover extensões de código gerenciado a partir de documentos.

The RemoveCustomization method.

Para obter a URL do manifesto de implantação que está associado ao documento.

The DeploymentManifestUrl property.

Consulte também

Tarefas

Como: Anexar extensões de código gerenciado aos documentos

Como: Remover extensões de código gerenciado a partir de documentos

Referência

Microsoft.VisualStudio.Tools.Applications.ServerDocument

Conceitos

Visual Studio Tools for Office visão geral sobre o tempo de execução

Cache de dados