Demonstra Passo a passo: Implantação de um documento e um assembly em diferentes pastas Local (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 localizados em diferentes pastas no computador de usuário final.Esse tipo de implantação é conhecido como o modelo de implantação local/local.

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 local.

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.

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 a solução implantação.

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.

Implantando a solução

Agora você pode implantar o documento e o assembly em pastas diferentes no computador de desenvolvimento.

Para implantar a solução

Criar pastas denominados TestDeployDocument e TestDeployAssembly na raiz da unidade do sistema do Windows (% SystemDrive %).Por exemplo, se sua unidade do sistema for C, as Novo pastas devem ser C:\TestDeployDocument e C:\TestDeployAssembly.
Copiar o documento da pasta de saída de compilação (normalmente projeto pasta\bin\Depurar ou projeto pasta \bin\versão) para a pasta %SystemDrive%\TestDeployDocument e copiar o assembly da pasta de saída de compilação para a pasta %SystemDrive%\TestDeployAssembly.
Abrir o documento na pasta %SystemDrive%\TestDeployDocument.Você verá uma mensagem de erro informando que o assembly de personalização não foi encontrado ou não pôde ser carregado.

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, em seguida, você deve editar manifesto do aplicativo incorporado para especificar o novo caminho de assembly.A Avançar seção explica essa etapa.
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 na Avançar etapa usando ServerDocument falhará.

Editando o manifesto de aplicativo incorporado

Você pode editar o manifesto do aplicativo incorporado no documento para apontar para o novo local do assembly de personalização, usando a classe ServerDocument.O código que usa ServerDocument para editar o manifesto do aplicativo incorporado deve ser fora do assembly Ferramentas do Visual Studio para o Office projeto associado ao 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 implantação no computador de desenvolvimento — por exemplo, C:\TestDeployDocument\WordDeployment.doc.Substituir De caminho de assembly completo com o caminho completo do assembly na pasta ele irá ser implantado para — por exemplo, C:\TestDeployAssembly\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();
    }
}

Pressionarionar F5 para Compilação 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.
Abrir o documento na pasta %SystemDrive%\TestDeployDocument.Você verá uma mensagem de erro informando que a atual política de segurança do .NET não permite a personalização para ser executado.Isso ocorre porque você tem não concedido completo Confiar para o assembly ainda.
Word Sair.

Tudo as instâncias do Word devem ser fechadas, ou as alterações da diretiva de segurança não terão efeito.

Configuração de diretiva de segurança

Para habilitar a solução ser executado, você deve conceder completo Confiar para o assembly em sua diretiva de segurança .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 ao conjunto de módulos (assembly)

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 -u -ag All_Code -url "full assembly path" FullTrust -n "Test_Deployment"
```
Substituir De caminho de assembly completo com o caminho completo do assembly no computador de desenvolvimento — por exemplo, C:\TestDeployAssembly\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.
Abrir o documento na pasta %SystemDrive%\TestDeployDocument e verifique se a mensagem aparece.

Próximas etapas

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