Como: Anexar as extensões de código gerenciado a documentos (Sistema de 2007)

Você pode anexar uma personalização de Ferramentas do Visual Studio para o Office a um documento do Microsoft Office Word 2007 existente ou a pasta de trabalho do Microsoft Office Excel 2007.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.

Observação:
T ele personalização falhará ao carregar i f a código espera controles que o documento especificado não tem.

Para anexar uma personalização de Ferramentas do Visual Studio para o Office a um documento do Word ou Excel, use o método AddCustomization da classe ServerDocument.Como a classe ServerDocument é projetada para ser executado em um computador que não tenha o Microsoft Office instalado, você pode usar esse método em soluções que não são baseadas em projetos de Ferramentas do Visual Studio para o Office (como um console ou Aplicativo Windows Forms).

Para anexar um documento extensões de código gerenciado

1. Criar um novo projeto que não Iniciar Word ou Excel, como um Aplicativo do Console ou projeto do Windows Forms.

2. No novo projeto, Adicionar uma referência para os assemblies a seguintes.

   • Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll

   • Microsoft.VisualStudio.Tools.Applications.Tempo de execução.v9.0.dll

3. Adicionar Os seguintes Imports ou as instruções using para o topo da seu arquivo de código.

   Imports Microsoft.VisualStudio.Tools.Applications
   Imports Microsoft.VisualStudio.Tools.Applications.Runtime
   

   using Microsoft.VisualStudio.Tools.Applications;
   using Microsoft.VisualStudio.Tools.Applications.Runtime;
   

4. Chame o método estático AddCustomization.

   O exemplo de código a seguir usa a sobrecarga de AddCustomization.Essa sobrecarga tem o caminho completo do documento e um Uri que especifica o local do manifesto da implantação para a personalização que você deseja anexar ao documento.Este exemplo assume que um documento do Word chamado WordDocument1.docx tem na área de trabalho, e que o manifesto de implantação está localizado em uma pasta chamada publicar que também é na área de trabalho.

   Dim documentPath As String = System.Environment.GetFolderPath( _
        Environment.SpecialFolder.Desktop) + "\WordDocument1.docx"
   Dim runtimeVersion As Integer = 0
   
   Try
       runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath)
   
       ' Make sure that this document does not yet have any Visual Studio Tools 
       ' for Office customizations.
       If runtimeVersion = 0 Then
           Dim deployManifestPath As String = System.Environment.GetFolderPath( _
               Environment.SpecialFolder.Desktop) & "\Publish\WordDocument1.vsto"
           Dim deploymentManifestUri As New Uri(deployManifestPath)
           ServerDocument.AddCustomization(documentPath, deploymentManifestUri)
           System.Windows.Forms.MessageBox.Show("The document was successfully customized.")
       Else
           System.Windows.Forms.MessageBox.Show("The document is already customized.")
       End If
   Catch ex As FileNotFoundException
       System.Windows.Forms.MessageBox.Show("The specified document does not exist.")
   Catch ex As DocumentNotCustomizedException
       System.Windows.Forms.MessageBox.Show("The document could not be customized." & _
           vbLf & ex.Message)
   End Try
   

   string documentPath = System.Environment.GetFolderPath(
       Environment.SpecialFolder.Desktop) + @"\WordDocument1.docx";
   int runtimeVersion = 0;
   
   try
   {
       runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath);
   
       // Make sure that this document does not yet have any Visual Studio Tools 
       // for Office customizations.
       if (runtimeVersion == 0)
       {
           string deployManifestPath = System.Environment.GetFolderPath(
               Environment.SpecialFolder.Desktop) + @"\Publish\WordDocument1.vsto";
   
           Uri deploymentManifestUri = new Uri(deployManifestPath);
           ServerDocument.AddCustomization(documentPath, deploymentManifestUri);
           System.Windows.Forms.MessageBox.Show("The document was successfully customized.");
       }
       else
       {
           System.Windows.Forms.MessageBox.Show("The document is already customized.");
       }
   }
   catch (FileNotFoundException)
   {
       System.Windows.Forms.MessageBox.Show("The specified document does not exist.");
   }
   catch (DocumentNotCustomizedException ex)
   {
       System.Windows.Forms.MessageBox.Show("The document could not be customized.\n" +
           ex.Message);
   }
   

Consulte também

Tarefas

Como: Gravar código que usa duAmbos versões da clAmbosse ServerDocument

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

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

Como: Anexar as extensões de código gerenciado a documentos (Sistema de 2003)

Conceitos

Gerenciando documentos em um servidor usando a classe do ServerDocument

Aplicativo e manifestos de implantação in Office Solutions