방법: 문서에 관리 코드 확장 연결

사용자 지정 어셈블리를 기존의 Microsoft Office Word 문서 또는 Microsoft Office Excel 통합 문서에 연결할 수 있습니다. 문서나 통합 문서의 형식은 Visual Studio 2010의 개발 도구와 Microsoft Office 프로젝트에서 지원하는 파일 형식일 수 있습니다. 자세한 내용은 문서 수준 사용자 지정 아키텍처를 참조하십시오.

적용 대상: 이 항목의 정보는 Excel 2007 및 Excel 2010, Word 2007 및 Word 2010의 문서 수준 프로젝트에 적용됩니다. 자세한 내용은 Office 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오.

사용자 지정을 Word 또는 Excel 문서에 연결하려면 ServerDocument 클래스의 AddCustomization 메서드를 사용합니다. ServerDocument 클래스는 Microsoft Office가 설치되어 있지 않은 컴퓨터에서 실행하도록 디자인되었으므로 콘솔 또는 Windows Forms 응용 프로그램과 같이 Microsoft Office 개발과 직접 관련되지 않은 솔루션에서 이 메서드를 사용할 수 있습니다.

관련 비디오 데모를 보려면 How Do I: Attach or Detach a VSTO Assembly from a Word Document?를 참조하십시오.

문서에 관리 코드 확장을 연결하려면

1. 콘솔 응용 프로그램이나 Windows Forms 프로젝트처럼 Microsoft Office가 필요하지 않은 프로젝트에서 다음 어셈블리 중 하나에 대한 참조를 추가합니다.

   • Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll 및 Microsoft.VisualStudio.Tools.Applications.Runtime.dll(.NET Framework 4를 대상으로 하는 프로젝트의 경우)

     또는

   • Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll 및 Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll(.NET Framework 3.5를 대상으로 하는 프로젝트의 경우)

2. 코드 파일의 맨 위에 다음 Imports or using 문을 추가합니다.

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

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

3. 정적 AddCustomization 메서드를 호출합니다.

   다음 코드 예제에서는 AddCustomization 오버로드를 사용합니다. 이 오버로드에서는 문서의 전체 경로 및 문서에 연결할 사용자 지정에 대한 배포 매니페스트의 위치를 지정하는 Uri를 사용합니다. 이 예제에서는 WordDocument1.docx라는 Word 문서가 데스크톱에 있고 배포 매니페스트가 데스크톱에 있는 Publish라는 폴더에 있다고 가정합니다.

   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);
   }
   

4. 프로젝트를 빌드하고 사용자 지정을 연결하려는 컴퓨터에서 응용 프로그램을 실행합니다. 이 컴퓨터에는 Visual Studio 2010 Tools for Office Runtime을 설치해야 합니다.

참고 항목

작업

방법: 문서에서 관리 코드 확장 제거

개념

ServerDocument 클래스를 사용하여 서버의 문서 관리

Office 솔루션의 응용 프로그램 및 배포 매니페스트