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

아티클
08/10/2011

Microsoft Office Word 또는 Microsoft Office Excel용 문서 수준 사용자 지정의 일부인 문서 또는 통합 문서에서 사용자 지정 어셈블리를 프로그래밍 방식으로 제거할 수 있습니다. 그런 다음 사용자가 문서를 열어 내용을 보면 문서에 추가한 사용자 지정 UI(사용자 인터페이스)가 표시되지 않고 코드가 실행되지 않습니다.

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

Microsoft Visual Studio Tools for Office Runtime에서 제공되는 RemoveCustomization 메서드 중 하나를 사용하여 사용자 지정 어셈블리를 제거할 수 있습니다. 사용하는 메서드는 Word 문서 또는 Excel 통합 문서가 열려 있는 동안 사용자 지정의 코드를 실행하여 런타임에 사용자 지정을 제거할지, 아니면 닫혀 있는 문서나 Microsoft Office가 설치되지 않은 서버에 있는 문서에서 사용자 지정을 제거할지에 따라 달라집니다.

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

런타임에 사용자 지정 어셈블리를 제거하려면

사용자 지정 코드에서 Document.RemoveCustomization 메서드(Word의 경우) 또는 Workbook.RemoveCustomization 메서드(Excel의 경우)를 호출합니다. 이 메서드는 사용자 지정이 더 이상 필요하지 않은 경우에만 호출해야 합니다.

코드에서 이 메서드를 호출하는 위치는 사용자 지정의 사용 방법에 따라 달라집니다. 예를 들어 고객이 다른 고객에게 문서를 보낼 준비가 되기 전까지 사용자 지정이 아닌 문서 자체에만 필요한 사용자 지정 기능을 사용하는 경우, 고객이 클릭하면 RemoveCustomization을 호출하는 몇 가지 UI를 제공할 수 있습니다. 또는 문서를 처음 열 때 사용자 지정을 통해 문서를 데이터로 채우지만 사용자 지정에서 고객이 직접 액세스할 수 있는 다른 기능을 제공하지 않는 경우, 사용자 지정에서 문서 초기화를 완료하는 즉시 RemoveCustomization을 호출할 수 있습니다.

닫혀 있는 문서 또는 서버에 있는 문서에서 사용자 지정 어셈블리를 제거하려면

콘솔 응용 프로그램이나 Windows Forms 프로젝트처럼 Microsoft Office가 필요하지 않은 프로젝트에서 다음 어셈블리 중 하나에 대한 참조를 추가합니다.
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll(.NET Framework 4를 대상으로 하는 프로젝트의 경우)
- Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll (.NET Framework 3.5를 대상으로 하는 프로젝트의 경우)

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

Imports Microsoft.VisualStudio.Tools.Applications

using Microsoft.VisualStudio.Tools.Applications;

ServerDocument 클래스의 정적 RemoveCustomization 메서드를 호출하고 매개 변수의 솔루션 문서 경로를 지정합니다.

다음 코드 예제에서는 데스크톱에 있는 WordDocument1.docx라는 문서에서 사용자 지정을 제거한다고 가정합니다.

Dim documentPath As String = System.Environment.GetFolderPath( _
    Environment.SpecialFolder.Desktop) & "\WordDocument1.docx"
Dim runtimeVersion As Integer = 0

Try
    runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath)
    If runtimeVersion = 3 Then
        ServerDocument.RemoveCustomization(documentPath)
        System.Windows.Forms.MessageBox.Show("The customization has been removed.")
    End If
Catch ex As FileNotFoundException
    System.Windows.Forms.MessageBox.Show("The specified document does not exist.")
Catch ex As IOException
    System.Windows.Forms.MessageBox.Show("The specified document is read-only.")
Catch ex As InvalidOperationException
    System.Windows.Forms.MessageBox.Show("The customization could not be removed." & _
        vbLf & ex.Message)
End Try

string documentPath = System.Environment.GetFolderPath(
    Environment.SpecialFolder.Desktop) + @"\WordDocument1.docx";
int runtimeVersion = 0;

try
{
    runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath);

    if (runtimeVersion == 3)
    {
        ServerDocument.RemoveCustomization(documentPath);
        System.Windows.Forms.MessageBox.Show("The customization has been removed.");
    }
}
catch (FileNotFoundException)
{
    System.Windows.Forms.MessageBox.Show("The specified document does not exist.");
}
catch (IOException)
{
    System.Windows.Forms.MessageBox.Show("The specified document is read-only.");
}
catch (InvalidOperationException ex)
{
    System.Windows.Forms.MessageBox.Show("The customization could not be removed.\n" +
        ex.Message);
}

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

다음을 통해 공유

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

런타임에 사용자 지정 어셈블리를 제거하려면

닫혀 있는 문서 또는 서버에 있는 문서에서 사용자 지정 어셈블리를 제거하려면

참고 항목

작업

개념

추가 리소스