Demonstra Passo a passo: Implantação de um documento e um Assembly para uma pasta de rede (sistema de 2003)

Artigo
08/25/2010

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de documento Versão do Microsoft Office Microsoft Office 2003 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

Projetos de nível de documento

Versão do Microsoft Office

Microsoft Office 2003

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Esta explicação passo a passo demonstra como implantar uma personalização de nível de documento para que o documento e o assembly em uma pasta em um computador da rede.Esse tipo de implantação é conhecido como o modelo de implantação/rede.

Para obter mais informações sobre as opções para implantar sua solução, consulte Modelos de implantação (sistema de 2003).Para obter mais informações sobre personalizações em nível de documento, consulte Arquitetura de personalizações de nível de documento.

Essa explicação passo a passo ilustra as seguintes tarefas:

Edição de manifesto do aplicativo incorporado em um documento para apontar para o assembly.
Conceder confiança total para uma solução Ferramentas do Visual Studio para o Office Assembly que está localizado em uma pasta rede.

Pré-requisitos

Para completar este passo a passo, são necessários os seguintes componentes:

Ferramentas do Visual Studio para o Office (um componente opcional do O Visual Studio 2008 Professional e Visual Studio Team System).

Microsoft Office Word 2003 ou Microsoft Office Excel 2003.

Observação:
Esta explicação passo a passo assume que você estiver implantando uma solução do Word.Se você quiser executar explicação passo a passo com uma solução do Excel, substitua o nome do projeto Word com o nome do seu projeto do Excel no Todo o Código exemplos.

O Acessar a um computador da rede para implantação.
Privilégios de administrador no computador de desenvolvimento, portanto, você pode definir a diretiva de segurança.

Criando uma solução Implantar

A Primeiro etapa é criar um Basic Ferramentas do Visual Studio para o Office solução para implantar.Se você já tiver uma solução que você deseja implantar, você pode ignorar esta seção e vá para "edição o Embedded Aplicativo manifesto".

Para criar uma solução para implantar

Criar um projeto de documento do Word com o nome WordDeployment, usando o modelo de projeto para o Office 2003.

No assistente, Selecionar Criar um documento novo.For more information, see Como: Criar o Visual Studio Tools para projetos do Office.
Em Gerenciador de Soluções, clique com o botão direito do mouse o arquivo de código ThisDocument e clique em Exibir Code.
Adicionar o seguinte código no manipulador de eventos ThisDocument_Startup.Esse código exibe uma mensagem quando o documento é aberto, que será facilitam verificar se a solução foi implantada com êxito.
```
MessageBox.Show("The deployment is successful")
```
```
MessageBox.Show("The deployment is successful");
```
Para obter mais informações sobre o evento Startup, consulte O Visual Studio Tools for Office Projeto eventos.
Pressionarionar F5 para Compilação e executar o projeto.Verifique se a mensagem é exibida.
Word Sair.
Fechar a solução no Visual Studio.

Garantir que o documento não seja Abrir em uma instância do Word ou o designer de projeto.Se o documento for Abrir, a tentativa para acessar o documento em uma etapa posterior usando ServerDocument falhará.

Editando o manifesto de aplicativo incorporado

Quando você Compilação sua solução, o documento considera que que o assembly esteja na mesma pasta do documento.O local do assembly é armazenado em um manifesto de aplicativo que está incorporado no documento.Se você implantar o documento e o assembly em pastas diferentes, você deve editar o manifesto do aplicativo incorporado para especificar o novo caminho de assembly.

Nas etapas a seguir, você usará a classe ServerDocument para editar o manifesto do aplicativo incorporado no documento para apontar para o novo local do assembly de personalização.O código que usa ServerDocument para editar o manifesto do aplicativo incorporado deve ser fora do assembly de projeto Ferramentas do Visual Studio para o Office associado com o documento que você estiver implantando.

Para editar o manifesto do aplicativo incorporado

Criar um novo projeto de Aplicativo do Console.For more information, see Como: Criar soluções e projetos.
Adicionar uma referência ao assembly Microsoft.VisualStudio.Tools.Applications.Tempo de execução.dll para o novo projeto.
Adicionar a seguinte instrução de using (C#) ou o Imports instrução (Visual Basic) para o início do arquivo Programa.cs ou Module1.vb código.
```
Imports Microsoft.VisualStudio.Tools.Applications.Runtime
```
```
using Microsoft.VisualStudio.Tools.Applications.Runtime;
```

Adicionar o seguinte código no método Main para atualizar o manifesto do aplicativo incorporado.Substituir completo documentar caminho com o caminho completo do documento em seu local de compilação no computador de desenvolvimento — por exemplo, projeto pasta \bin\Depurar\WordDeployment.doc.Substituir De caminho de assembly completo com o caminho completo do assembly na pasta rede, ele irá ser implantado para — por exemplo, \\DeploymentServer\DeploymentFolder\WordDeployment.dll.

Dim sd As ServerDocument = Nothing
Try
    sd = New ServerDocument("full document path")
    sd.AppManifest.Dependency.AssemblyPath = _
        "full assembly path"
    sd.Save()
Finally
    If Not sd Is Nothing Then
        sd.Close()
    End If
End Try

ServerDocument sd = null;
try
{
    sd = new ServerDocument(@"full document path");
    sd.AppManifest.Dependency.AssemblyPath = 
        @"full assembly path";
    sd.Save();
}
finally
{
    if (sd != null)
    {
        sd.Close();
    }
}

Criar e executar o projeto.O Aplicativo do Console atualiza o caminho de assembly no manifesto do aplicativo incorporado e, em seguida, fecha.
Fechar o projeto de Aplicativo do Console.

Implantando a solução

Agora que os caminhos estão corretos, você pode implantar o documento e o assembly para a mesma pasta no computador da rede.

Para implantar a solução

Criar uma pasta chamada DeploymentFolder em um computador de rede e compartilhar a pasta para você mesmo.Por exemplo, se o computador da rede for denominado DeploymentServer, o novo Compartilhar de rede poderia ser \\DeploymentServer\DeploymentFolder.Verifique se o Compartilhar de rede tem o mesmo nome que você especificou no espaço reservado para assembly completo caminho quando você Editado o manifesto do aplicativo incorporado nas etapas anteriores.
Copiar o documento e o assembly da compilação de saída de pasta (geralmente projeto pasta\bin\Depurar ou projeto pasta \bin\versãosão) para o Compartilhar de rede \\DeploymentServersão\DeploymentFolder.
Abrir o documento no Compartilhar de rede \\DeploymentServer\DeploymentFolder.Você verá uma mensagem de erro informando que o assembly de personalização não foi encontrado ou não pôde ser carregado.Isso ocorre porque você tem não concedido completo Confiar ao documento e o assembly na pasta de rede.
Clique em OK e, em seguida, Fechar o documento.

Configuração de diretiva de segurança

Para habilitar a solução ser executado, você deve conceder completo Confiar para o assembly e o documento na sua diretiva de segurança do .NET Framework 2.0.Nesta explicação passo a passo usa a ferramenta de Política de segurança de Acessar ao código (Caspol.exe) para conceder completo Confiar ao conjunto de módulos (assembly).Para obter mais informações sobre como usar Caspol.exe, consulte Código Acessar Segurança Policy Tool (Caspol.exe) e Configurando a diretiva de segurança usando o código Acessar Security Policy Tool (Caspol.exe).

Observação de segurança:
Esses são Basic etapas para a configuração uma diretiva de segurança com base em evidências de URL para a finalidade de concluir esta explicação passo a passo.Não use essas etapas para conceder Confiar aos assemblies em uma solução de mundo real se você não tiver certeza de que o local será seguro.Você também deve basear a segurança de uma solução do mundo real em mais evidências do que a URL do assembly.Para obter mais informações, consulte Requisitos de segurança para executar o Office Solutions (sistema de 2003).

Esses são Basic etapas para a configuração uma diretiva de segurança com base em evidências de URL para a finalidade de concluir esta explicação passo a passo.Não use essas etapas para conceder Confiar aos assemblies em uma solução de mundo real se você não tiver certeza de que o local será seguro.Você também deve basear a segurança de uma solução do mundo real em mais evidências do que a URL do assembly.Para obter mais informações, consulte Requisitos de segurança para executar o Office Solutions (sistema de 2003).

Para conceder completo Confiar para o assembly e o documento

No prompt de comando, tipo o seguinte comando para criar um novo AAgruparar de códigos conceConfiar Completo ao conjunto de módulos (assembly).
```
%windir%\Microsoft.NET\Framework\v2.0.50727\caspol -m -ag LocalIntranet_Zone -url "full assembly path" FullTrust -n "Test_Deployment_Assembly"
```
Substituir De caminho de assembly completo com o caminho completo do assembly na pasta de rede — por exemplo, \\DeploymentServer\DeploymentFolder\WordDeployment.dll.

O parâmetro -n especifica um nome para o novo AAgruparar de códigos.Este parâmetro não é necessário, mas especificar um rótulo facilita a mais tarde identificar e remover o novo AAgruparar de códigos depois de concluir esta explicação passo a passo.
tipo Sim quando solicitado a confirmar que você deseja executar a operação e Pressionarionar ENTER.
tipo o seguinte comando para criar um novo AAgruparar de códigos que conceConfiar para o documentCompleto e Pressionarionar ENTER.Você deve conceder completo Confiar para o documento porque você, como o usuário final irá abri-lo da pasta de rede.Documentos não exigem completo Confiar se estiverem no computador de usuário final.
```
%windir%\Microsoft.NET\Framework\v2.0.50727\caspol -m -ag LocalIntranet_Zone -url "full document path" FullTrust -n "Test_Deployment_Document"
```
Substituir completo documentar caminho com o caminho completo do documento na pasta de rede — por exemplo, \\DeploymentServer\DeploymentFolder\WordDeployment.doc.

O parâmetro -n especifica um nome para o novo AAgruparar de códigos.Este parâmetro não é necessário, mas especificar um rótulo facilita a mais tarde identificar e remover o novo AAgruparar de códigos depois de concluir esta explicação passo a passo.
tipo Sim quando solicitado a confirmar que você deseja executar a operação e Pressionarionar ENTER.
No seu computador de desenvolvimento, Abrir o documento no \\DeploymentServer\DeploymentFolder pasta de rede e verifique se a mensagem é exibida.
Salvar o documento em uma pasta no computador de desenvolvimento e, em seguida, Fechar o documento.
Abrir o documento no computador de desenvolvimento e verifique se a mensagem aparece.

Isso funciona porque o manifesto do aplicativo incorporado inclui o caminho completo do assembly no computador da rede.Se você não editar o caminho do Assembly no manifesto do aplicativo incorporado, a solução seria executada somente se você abrir o documento da pasta rede.

Próximas etapas

Você também pode implantar o documento e o assembly em pastas Local ou você pode implantar somente o assembly em uma pasta de rede.Para obter mais informações, consulte as seguintes orientações: