Como: Anexar as extensões de código gerenciado a documentos (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.

Você pode anexar uma solução Ferramentas do Visual Studio para o Office Assembly a um documento do Microsoft Office Word 2003 existente ou a pasta de trabalho do Microsoft Office Excel 2003.O documento ou pasta de trabalho pode estar em qualquer Formatarar de arquivo que é suportado pelo Ferramentas do Visual Studio para o Office.For more information, see Arquitetura de personalizações de nível de documento.

Se você anexar uma solução Assembly a um documento que ainda não tem personalizações de Ferramentas do Visual Studio para o Office , o runtime Ferramentas do Visual Studio para o Office automaticamente cria um Controlarar de armazenamento em tempo de execução no documento.For more information, see Visão geral do Controlarar em tempo de execução armazenamento.

Observação:
Se o documento especificado não contém um Controlarar que o assembly de solução espera o documento tiver, o assembly não serão Carregar quando o usuário abre o documento.

Há duas maneiras para anexar uma solução Assembly a um documento:

Manualmente, defina propriedades de documento Personalizars no documento propriamente dito.
Programaticamente anexar o assembly usando a classe ServerDocument.

Usando Propriedades do documento Personalizar

Você pode anexar uma solução Ferramentas do Visual Studio para o Office Assembly a um documento Word ou Excel Configurando manualmente o _AssemblyName e _AssemblyLocation propriedades Personalizars do documento.For more information, see Visão geral de propriedades de documento Personalizar.

O procedimento a seguir supõe que você já implantou o assembly de solução e que a solução usa um manifesto de implantação.For more information, see Implantação de personalizações de nível de documento (sistema de 2003).

Para anexar uma solução Assembly, definindo as propriedades personalizadas do documento

Abrir o documento no Word ou Excel.
No menu Arquivo , clique em Propriedadese clique na guia de Personalizar.
Defina a propriedade _AssemblyName:
1. Se _AssemblyName aparecer na lista propriedades, Selecionar _AssemblyName, e tipo um asterisco na caixa de valor.
2. Se _AssemblyName não estiver na lista, tipo _AssemblyName na caixa Nome, digite um asterisco na caixa de valor e clique em Adicionar.

Defina a propriedade _AssemblyLocation:

Se _AssemblyLocation aparecer na lista propriedades, Selecionar _AssemblyLocation, e tipo o caminho completo do manifesto da implantação na caixa de valor.
Se _AssemblyLocation não estiver na lista, tipo _AssemblyLocation na caixa Nome, digite o caminho completo do manifesto da implantação na caixa de valor e clique em Adicionar.

O local do manifesto de implantação pode ser um caminho de disco (C:\deploy\Document1.Aplicativo), um Compartilhar de arquivo (\\Servidor\Document1.Aplicativo) ou um site da Web (https://www.contoso.com/Document1.Aplicativo).

Observação:
O valor de uma propriedade de documento Personalizar pode conter 255 caracteres.Se o caminho de manifesto for maior que 255 caracteres, Criar uma propriedade chamada _AssemblyLocation0 e defina essa propriedade para os primeiros 255 caracteres no caminho.Em seguida, Criar uma propriedade chamada _AssemblyLocation1 e defina esta propriedade como os caracteres restantes no caminho de manifesto.

Clique em OK e, em seguida, Salvar e Fechar o documento.

Na Avançar vez o documento é aberto e salvo, o runtime Ferramentas do Visual Studio para o Office anexa o assembly de solução ao documento e cria o Controlarar de armazenamento em tempo de execução, se necessário.O runtime Ferramentas do Visual Studio para o Office também define o valor da propriedade _AssemblyLocation Personalizars de documento para o GUID para o Controlarar de armazenamento em tempo de execução.For more information, see Visão geral do Controlarar em tempo de execução armazenamento.

Observação:
O documento deve ser aberto e salvo em um computador que possui o Tempo de execução de Ferramentas do Visual Studio para o Office instalado.For more information, see Como: Instalar o Visual Studio Tools para Office Tempo de execução.

Usando a classe do ServerDocument

Você pode anexar uma solução Ferramentas do Visual Studio para o Office Assembly a um documento Word ou Excel usando o método AddCustomization da classe ServerDocument.Você deve colocar o código que usa a classe ServerDocument em um novo projeto (não a solução Ferramentas do Visual Studio para o Office) por exemplo em um projeto do Windows Forms.Além disso, o documento ao qual associar o assembly deve ser Fechada, e o documento deve estar em um computador em que Word (para documentos do Word) ou do Excel (para pastas de trabalho do Excel) instalado.

Para anexar uma solução Assembly a um documento usando a classe do ServerDocument

Criar um novo projeto de Windows Forms.
Adicionar uma referência ao assembly Microsoft.VisualStudio.Tools.Applications.Tempo de execução.dll ao projeto.

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;

Chamar o método estático AddCustomization da classe ServerDocument e especificar o caminho do documento de solução, o nome do assembly e o caminho de manifesto de implantação nos parâmetros.O código a seguir pressupõe que você anexar um assembly a um documento do Word chamado WordDocument1.doc está localizado na pasta C:\WordDocument1, e o manifesto do assembly e a implantação estão localizadas na de Compartilhar de rede \\deployserver\WordDocument1\.

Private Sub AddNewCustomization()

    Dim fileName As String = "C:\WordDocument1\WordDocument1.doc"

    If Not ServerDocument.IsCustomized(fileName) Then

        Dim assemblyName As String = "\\deployserver\WordDocument1\WordDocument1.dll"
        Dim manifestPath As String = "\\deployserver\WordDocument1\WordDocument1.application"
        Dim applicationVersion As String = "1.0.0.0"

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

    Else
        System.Windows.Forms.MessageBox.Show( _
            "The specified document is already customized.")
    End If
End Sub

private void AddNewCustomization()
{
    string fileName = @"C:\WordDocument1\WordDocument1.doc";

    if (!ServerDocument.IsCustomized(fileName))
    {
        string assemblyName = @"\\deployserver\WordDocument1\WordDocument1.dll";
        string manifestPath = @"\\deployserver\WordDocument1\WordDocument1.application";
        string applicationVersion = "1.0.0.0";

        ServerDocument.AddCustomization(
            fileName, assemblyName, manifestPath, applicationVersion, false);
    }
    else
    {
        System.Windows.Forms.MessageBox.Show(
            "The specified document is already customized.");
    }
}

O runtime Ferramentas do Visual Studio para o Office anexa o assembly de solução para o documento e cria um Controlarar de armazenamento em tempo de execução, se necessário.For more information, see Visão geral do Controlarar em tempo de execução armazenamento.