DocumentExtensions.GetVstoObject 메서드 (_Document, ApplicationFactory)

아티클
08/10/2011

응용 프로그램 수준 추가 기능에서 현재 Microsoft.Office.Interop.Word.Document 개체의 기능을 확장하는 Microsoft.Office.Tools.Word.Document 호스트 항목을 반환합니다. 프로젝트의 Globals.Factory 개체를 factory 매개 변수에 전달합니다.

네임스페이스: Microsoft.Office.Tools.Word.Extensions
어셈블리: Microsoft.Office.Tools.Word.v4.0.Utilities(Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

구문

‘선언
<ExtensionAttribute> _
Public Shared Function GetVstoObject ( _
    document As _Document, _
    factory As ApplicationFactory _
) As Document

public static Document GetVstoObject(
    this _Document document,
    ApplicationFactory factory
)

매개 변수

document
형식: Microsoft.Office.Interop.Word._Document
확장할 네이티브 문서 개체입니다.이 매개 변수를 직접 지정하지 마십시오.Word 문서에서 이 메서드를 호출하면 런타임에서 이 매개 변수를 제공합니다.

factory
형식: Microsoft.Office.Tools.Word.ApplicationFactory
응용 프로그램 수준 추가 기능에서 특정 기능에 대한 액세스를 제공하는 개체입니다.Globals.Factory 개체를 이 매개 변수에 전달합니다.

반환 값

형식: Microsoft.Office.Tools.Word.Document
현재 Microsoft.Office.Interop.Word.Document 개체의 기능을 확장하는 호스트 항목입니다.

사용 정보

Visual Basic 및 C#에서는 이 메서드를 _Document 형식의 모든 개체에서 인스턴스 메서드로 호출할 수 있습니다. 인스턴스 메서드 구문을 사용하여 이 메서드를 호출할 경우에는 첫 번째 매개 변수를 생략합니다. 자세한 내용은 확장 메서드(Visual Basic) 또는 확장 메서드(C# 프로그래밍 가이드)를 참조하십시오.

설명

응용 프로그램 수준 추가 기능에서 Word에 열려 있는 문서를 확장하려면 이 메서드를 호출하십시오. 이 메서드는 이 메서드를 호출하는 Microsoft.Office.Interop.Word.Document 개체에 대해 이러한 개체가 생성되지 않은 경우 새 Microsoft.Office.Tools.Word.Document 호스트 항목을 생성합니다. 동일한 Microsoft.Office.Interop.Word.Document 개체에서 이 메서드를 다시 호출하면 같은 Microsoft.Office.Tools.Word.Document 인스턴스를 반환합니다.

이 메서드는 대상을 변경할 Office 프로젝트 이전 버전과의 호환성을 위해 .NET Framework 3.5 .NET Framework 4 에 제공됩니다. .NET Framework 4를 대상으로 하는 새 프로젝트에서는 프로젝트의 Globals.Factory 개체에서 제공하는 GetVstoObject 메서드를 호출해야 합니다.

자세한 내용은 런타임에 응용 프로그램 수준 추가 기능의 Word 문서 및 Excel 통합 문서 확장을 참조하십시오.

참고

document 매개 변수는 Microsoft.Office.Interop.Word._Document 형식인데 이 형식은 Microsoft.Office.Interop.Word.Document의 부모 인터페이스입니다. 따라서 이 메서드는 Microsoft.Office.Interop.Word._Document 및 Microsoft.Office.Interop.Word.Document 형식을 모두 확장합니다. 대개 Word 문서를 참조할 때는 Microsoft.Office.Interop.Word.Document를 사용합니다.