ApplicationFactory.GetVstoObject 메서드 (_Workbook)

아티클
05/08/2013

지정된 네이티브 통합 문서 개체의 기능을 확장하는 Microsoft.Office.Tools.Excel.Workbook 호스트 항목을 반환합니다.

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

구문

‘선언
Function GetVstoObject ( _
    workbook As _Workbook _
) As Workbook

Workbook GetVstoObject(
    _Workbook workbook
)

매개 변수

workbook
형식: Microsoft.Office.Interop.Excel._Workbook
확장 개체를 검색할 네이티브 통합 문서 개체입니다.이 매개 변수는 Microsoft.Office.Interop.Excel._Workbook 형식이지만 일반적으로 Microsoft.Office.Interop.Excel.Workbook 개체를 이 메서드에 전달합니다.

반환 값

형식: Microsoft.Office.Tools.Excel.Workbook
네이티브 통합 문서 개체의 기능을 확장하는 호스트 항목입니다.

설명

Excel에 열려 있는 통합 문서를 사용자 지정하려면 응용 프로그램 수준 추가 기능에서 이 메서드를 호출하십시오.Microsoft.Office.Tools.Excel.Workbook 개체가 이미 생성되어 있지 않은 경우 이 메서드는 이 개체를 새로 생성합니다.이 메서드를 다시 호출하면 기존 Microsoft.Office.Tools.Excel.Workbook 개체의 캐시된 인스턴스가 반환됩니다.자세한 내용은 런타임에 응용 프로그램 수준 추가 기능의 Word 문서 및 Excel 통합 문서 확장을 참조하십시오.

[!참고]

workbook 매개 변수는 Microsoft.Office.Interop.Excel._Workbook 형식인데 이 형식은 Microsoft.Office.Interop.Excel.Workbook의 부모 인터페이스입니다.따라서 이 메서드는 두 유형의 개체를 받아들일 수: 및 Microsoft.Office.Interop.Excel._Workbook Microsoft.Office.Interop.Excel.Workbook.대개 Excel 통합 문서를 참조할 때는 Microsoft.Office.Interop.Excel.Workbook을 사용합니다.

예제

다음 코드 예제에서는 사용 중인 Excel 통합 문서의 Microsoft.Office.Tools.Excel.Workbook 호스트 항목을 만듭니다.이 코드를 사용 하려면 실행 된 ThisAddIn 클래스는 Excel 추가 기능에서 프로젝트를 대상으로 .NET Framework 4 또는 .NET Framework 4.5.

Dim vstoWorkbook As Workbook = _
    Globals.Factory.GetVstoObject(Me.Application.ActiveWorkbook)

For Each st As SmartTag In vstoWorkbook.VstoSmartTags
    System.Windows.Forms.MessageBox.Show(st.Caption)
Next

Workbook vstoWorkbook =
    Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook);

foreach (SmartTag st in vstoWorkbook.VstoSmartTags)
{
    System.Windows.Forms.MessageBox.Show(st.Caption);
}