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

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 Sistema de 2007 Microsoft Office 2003 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Você pode criar um arquivo de código que usa a classe ServerDocument para gerenciar as personalizações para o Microsoft Office 2003 e o Microsoft Office Sistema de 2007.Isso ajuda a criar um assembly que contém códigos reutilizáveis, quando você precisa gerenciar personalizações para Múltiplo versões do Microsoft Office.

Para obter informações sobre as diferenças entre as duas versões da classe ServerDocument , consulte Gerenciando documentos em um servidor usando a classe do ServerDocument.

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

1. Adicione referências para os seguintes conjuntos de módulos (assemblies) :

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

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

2. Adicionar Os seguintes using (para Visual C#) ou as instruções Imports (para o Visual Basic) à parte superior da seu arquivo de código.Essas instruções Definirm aliases para os espaços para nome de cada uma das versões da classe ServerDocument.

   Imports v3Runtime = Microsoft.VisualStudio.Tools.Applications
   Imports SERuntime = Microsoft.VisualStudio.Tools.Applications.Runtime
   

   using v3Runtime = Microsoft.VisualStudio.Tools.Applications;
   using SERuntime = Microsoft.VisualStudio.Tools.Applications.Runtime;
   

3. Use o método GetCustomizationVersion para determinar qual versão do Tempo de execução Ferramentas do Visual Studio para o Office foi usado para criar a personalização.Em seguida, use a classe ServerDocument nessa versão do Tempo de execução para trabalhar com a personalização.

   O exemplo de código a seguir examina a personalização que está associada com um documento especificado.Se o documento foi personalizado usando o Microsoft Visual Studio Tools para o Microsoft Office system (versão 3.0 Runtime) (isto é, por usando um projeto para o Word 2007), o exemplo exibe a URL do manifesto da implantação.Se o documento foi personalizado usando o O Visual Studio 2005 Tools for Office Second Edition runtime (isto é, por usando um projeto para o Word 2003), o exemplo exibe o conteúdo do manifesto do aplicativo incorporado.

   Private Sub DisplayCustomizationInformation(ByVal documentPath As String)
       Dim runtimeVersion As Integer = 0
       Dim serverDocumentv3 As v3Runtime.ServerDocument = Nothing
       Dim serverDocumentSE As SERuntime.ServerDocument = Nothing
   
       Try
           runtimeVersion = v3Runtime.ServerDocument.GetCustomizationVersion(documentPath)
   
           ' Access a member that is specific to each version of the runtime.
           If runtimeVersion = 3 Then
               serverDocumentv3 = New v3Runtime.ServerDocument(documentPath)
               MessageBox.Show("The URL of the deployment manifest is: " & vbLf & _
                   serverDocumentv3.DeploymentManifestUrl.ToString())
           ElseIf runtimeVersion = 2 Then
               serverDocumentSE = New SERuntime.ServerDocument(documentPath)
               MessageBox.Show("The embedded application manifest has the following contents: " & vbLf _
                   & serverDocumentSE.AppManifest.ToXml())
           End If
   
       Catch ex As System.IO.FileNotFoundException
           System.Windows.Forms.MessageBox.Show("The specified document does not exist.")
       Finally
           If Not (serverDocumentv3 Is Nothing) Then
               serverDocumentv3.Close()
           End If
           If Not (serverDocumentSE Is Nothing) Then
               serverDocumentSE.Close()
           End If
       End Try
   End Sub
   

   private void DisplayCustomizationInformation(string documentPath)
   {
       int runtimeVersion = 0;
       v3Runtime.ServerDocument serverDocumentv3 = null;
       SERuntime.ServerDocument serverDocumentSE = null;
   
       try
       {
           runtimeVersion = v3Runtime.ServerDocument.GetCustomizationVersion(documentPath);
   
           // Access a member that is specific to each version of the runtime.
           if (runtimeVersion == 3)
           {
               serverDocumentv3 = new v3Runtime.ServerDocument(documentPath);
               MessageBox.Show("The URL of the deployment manifest is: \n" +
                   serverDocumentv3.DeploymentManifestUrl.ToString());
           }
           else if (runtimeVersion == 2)
           {
               serverDocumentSE = new SERuntime.ServerDocument(documentPath);
               MessageBox.Show("The embedded application manifest has the following contents: \n" +
                   serverDocumentSE.AppManifest.ToXml());
           }
       }
       catch (System.IO.FileNotFoundException)
       {
           System.Windows.Forms.MessageBox.Show("The specified document does not exist.");
       }
       finally
       {
           if (serverDocumentv3 != null)
               serverDocumentv3.Close();
           if (serverDocumentSE != null)
               serverDocumentSE.Close();
       }
   }
   

Consulte também

Conceitos

Gerenciando documentos em um servidor usando a classe do ServerDocument

Referência

Microsoft.VisualStudio.Tools.Applications.ServerDocument

Microsoft.VisualStudio.Tools.Applications.Runtime.ServerDocument