Compartilhar via

Como: Atualizar os caminhos de manifesto do assembly do aplicativo por programação (sistema de 2003)

  • Artigo

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.

Você pode usar o modelo de objeto no Tempo de execução Ferramentas do Visual Studio para o Office para atualizar programaticamente o manifesto do aplicativo que está incorporado em um documento que faz parte de uma personalização de nível de documento.

Quando você alterar os caminhos para os assemblies, você deve criar um novo manifesto de aplicativo e substituir aquele que tem os caminhos desatualizados.Você pode usar variáveis de ambiente, como % ProgramFiles % ou % UserProfile %, nos caminhos para os assemblies.

Você deve colocar o código para manipular o modelo de objeto em um novo projeto (não a solução Ferramentas do Visual Studio para o Office) como um Aplicativo do Console ou projeto do Windows Forms.Ferramentas do Visual Studio para o Office inclui um exemplo que demonstra como criar uma ferramenta que pode ser usada para editar o manifesto do aplicativo incorporado.For more information, see Exemplo do ServerDocument.

Há outro modelo de manifestos de atualização que envolve a modificação de arquivos XML em um servidor.For more information, see Como: Alterar o local de personalizações de nível de documento (sistema de 2003).

Observação:

Este tópico não se aplica ao nível de aplicativo Adicionar-ins, porque eles não usam incorporado manifestos de aplicativo.Para alterar o caminho para o Adicionar no assembly, use um editor de texto para atualizar o manifesto de aplicativo que está no computador cliente.Para obter mais informações, consulte Manifestos de aplicativo para soluções do Office (Sistema de 2003).Para obter mais informações sobre o nível de aplicativo Adicionar-ins e personalizações em nível de documento, consulte Arquitetura de personalizações de nível de documento.

Alterar o caminho para os assemblies por meio de programação

  1. Adicionar uma referência a Microsoft.VisualStudio.Tools.Office.Runtime.v9.0 ao seu projeto objeto modelo de manipulação se você não já tiver um.

  2. Adicionar um Imports ou using instrução tempo de execução para a parte superior do seu arquivo de código.

    Imports Microsoft.VisualStudio.Tools.Applications.Runtime

    using Microsoft.VisualStudio.Tools.Applications.Runtime;

  3. Chame o método estático AddCustomization da classe ServerDocument e passar os argumentos obrigatórios.Você primeiro deve chamar o método de RemoveCustomization para remover as personalizações de Ferramentas do Visual Studio para o Office existente do documento, ou AddCustomization lançará um InvalidOperationException.

    Dim solutionDocument As String = "C:\Documents\ExcelApplication.xls"
Dim assemblyName As String = "ExcelApplication.dll"
Dim manifestPath As String = "\\serversame\deployshare\ExcelApplication.application"
Dim applicationVersion As String = "1.0.0.1"

If ServerDocument.IsCustomized(solutionDocument) Then
    ServerDocument.RemoveCustomization(solutionDocument)
End If

ServerDocument.AddCustomization( _
    solutionDocument, assemblyName, manifestPath, _
    applicationVersion, False)

    string solutionDocument = @"C:\Documents\ExcelApplication.xls";
string assemblyName = "ExcelApplication.dll";
string manifestPath = @"\\servername\deployshare\ExcelApplication.application";
string applicationVersion = "1.0.0.1";

if (ServerDocument.IsCustomized(solutionDocument))
{
    ServerDocument.RemoveCustomization(solutionDocument);
}

ServerDocument.AddCustomization(
    solutionDocument, assemblyName, manifestPath, 
    applicationVersion, false);

Consulte também

Tarefas

Como: Alterar o caminho para o manifesto de implantação por programação (sistema de 2003)

Como: Remover extensões de código gerenciado de documentos (Sistema de 2003)

Conceitos

Aplicativo e manifestos de implantação in Office Solutions

Implantando soluções do Office (Sistema de 2003)

Referência

Manifestos de aplicativo para soluções do Office (Sistema de 2003)

Manifestos de implantação para soluções do Office (sistema de 2003)