통합 문서 호스트 항목

아티클
08/10/2011

Workbook 호스트 항목은 Excel의 주 interop 어셈블리의 Microsoft.Office.Interop.Excel.Workbook 형식을 확장하는 형식입니다. Workbook 호스트 항목은 Microsoft.Office.Interop.Excel.Workbook 개체와 동일한 속성, 메서드 및 이벤트를 모두 제공하지만 추가 기능도 제공합니다.

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

문서 수준 프로젝트에는 프로젝트의 통합 문서를 나타내는 기본 Workbook 호스트 항목이 있습니다. 응용 프로그램 수준 프로젝트에서는 런타임에 Workbook 호스트 항목을 생성할 수 있습니다.

문서 수준 프로젝트의 통합 문서 호스트 항목 이해

프로젝트의 통합 문서에 액세스하려면 ThisWorkbook 클래스를 사용합니다. ThisWorkbook 클래스를 통해 Workbook 호스트 항목의 멤버에 액세스하여 사용자 지정에서 통합 문서가 열리거나 닫힐 때 코드를 실행하는 등의 기본 작업을 수행할 수 있습니다. 자세한 내용은 문서 수준 사용자 지정 프로그래밍을 참조하십시오.

ThisWorkbook 클래스를 프로젝트의 코드를 작성하는 출발점으로 삼을 수 있습니다. ThisWorkbook 클래스에서는 Excel용 주 interop 어셈블리의 Microsoft.Office.Interop.Excel.Workbook 개체와 동일한 속성, 메서드 및 이벤트를 모두 제공하므로 이 클래스를 사용하여 Excel의 개체 모델에 액세스할 수도 있습니다. 자세한 내용은 Excel 개체 모델 개요를 참조하십시오.

솔루션 탐색기에서 ThisWorkbook 프로젝트 항목을 두 번 클릭하여 통합 문서 디자이너를 표시하고 속성 창에서 통합 문서의 속성과 이벤트를 봅니다.

문서 수준 프로젝트의 통합 문서 호스트 항목의 제한 사항

문서 수준 프로젝트에는 Workbook 호스트 항목, 즉 ThisWorkbook 클래스만 포함될 수 있습니다. 디자인 타임에 새 Workbook 호스트 항목을 프로젝트에 추가할 수는 없으며 런타임에 문서 수준 사용자 지정에서 새 Workbook 호스트 항목을 만들 수도 없습니다.

런타임에 새 Excel 통합 문서를 만들면 해당 문서는 Microsoft.Office.Interop.Excel.Workbook 형식이 됩니다. 이 문서는 호스트 항목이 아니므로 호스트 컨트롤이나 Windows Forms 컨트롤을 포함할 수 없습니다. 런타임에 통합 문서를 만드는 방법에 대한 자세한 내용은 방법: 새 통합 문서 만들기를 참조하십시오.

Workbook 호스트 항목은 호스트 컨트롤의 컨테이너로 사용되지 않습니다. 따라서 통합 문서에 표시되는 컨트롤을 추가할 수는 없지만 DataSet 같은 구성 요소를 추가하여 구성 요소를 모든 워크시트에서 공유할 수 있습니다. 문서 수준 프로젝트에서 통합 문서에 사용할 수 있는 구성 요소는 도구 상자의 구성 요소 탭, 데이터 탭 및 모든 Windows Forms 탭에 있습니다.

참고

Visual Studio의 Office 개발 도구는 공유 통합 문서를 지원하지 않습니다.

응용 프로그램 수준 프로젝트의 통합 문서 호스트 항목 이해

응용 프로그램 수준 프로젝트에서는 런타임에 Excel에 열려 있는 통합 문서에 대한 Workbook 호스트 항목을 생성할 수 있습니다. Workbook 호스트 항목을 생성하려면 GetVstoObject 메서드를 사용합니다. 자세한 내용은 런타임에 응용 프로그램 수준 추가 기능의 Word 문서 및 Excel 통합 문서 확장을 참조하십시오.