통합 문서 호스트 항목
Workbook 호스트 항목은 Excel용 주 interop 어셈블리의 Workbook 형식을 확장한 형식입니다. Workbook 호스트 항목은 Workbook 개체와 동일한 속성, 메서드 및 이벤트를 제공하지만 추가 기능도 제공합니다.
적용 대상: 이 항목의 정보는 Excel의 문서 수준 프로젝트 및 VSTO 추가 기능 프로젝트에 적용됩니다. 자세한 내용은 Office 애플리케이션 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하세요.
문서 수준 프로젝트에는 프로젝트의 통합 문서를 나타내는 기본 Workbook 호스트 항목이 있습니다. VSTO 추가 기능 프로젝트에서 런타임에 Workbook 호스트 항목을 생성할 수 있습니다.
문서 수준 프로젝트의 통합 문서 호스트 항목 이해
프로젝트의 통합 문서에 액세스하려면 ThisWorkbook 클래스를 사용합니다. ThisWorkbook 클래스는 Workbook 호스트 항목의 멤버에 대한 액세스를 제공하여 통합 문서를 열거나 닫을 때 코드를 실행하는 등 사용자 지정에서 기본 작업을 수행합니다. 자세한 내용은 문서 수준 사용자 지정 프로그래밍을 참조하세요.
ThisWorkbook 클래스는 프로젝트에서 코드를 작성하기 시작할 수 있는 위치를 제공합니다. 이 클래스는 Excel용 주 interop 어셈블리의 Workbook 개체와 동일한 속성, 메서드 및 이벤트를 제공하므로 ThisWorkbook 을 사용하여 Excel의 개체 모델에 액세스할 수 있습니다. 자세한 내용은 Excel 개체 모델 개요를 참조하세요.
솔루션 탐색기 에서 ThisWorkbook 프로젝트 항목을 두 번 클릭하면 통합 문서 디자이너가 표시되고 속성 창에 통합 문서의 속성 및 이벤트가 표시됩니다.
문서 수준 프로젝트에서 통합 문서 호스트 항목 제한
문서 수준의 프로젝트에는 하나의 Workbook 호스트 항목(즉, ThisWorkbook 클래스)만 포함할 수 있습니다. 문서 수준 사용자 지정에서는 디자인 타임에 새 Workbook 호스트 항목을 프로젝트에 추가할 수 없고 런타임에 새 Workbook 호스트 항목을 만들 수 없습니다.
런타임에 새 Excel 통합 문서를 만드는 경우 Workbook형식이 됩니다. 이 형식은 호스트 항목이 아니므로 호스트 컨트롤 또는 Windows Forms 컨트롤을 포함할 수 없습니다. 런타임에 통합 문서를 만드는 방법에 대한 자세한 내용은 방법: 프로그래밍 방식으로 새 통합 문서 만들기를 참조하세요.
Workbook 호스트 항목은 호스트 컨트롤의 컨테이너로 사용되지 않습니다. 그러므로 통합 문서에 보이는 컨트롤을 추가할 수 없지만 DataSet등의 구성 요소는 추가할 수 있으므로 모든 워크시트에서 구성 요소를 공유할 수 있습니다. 도메인 수준 프로젝트에서 통합 문서에 사용할 수 있는 구성 요소는 도구 상자 의 구성 요소 탭, 데이터 탭 및 모든 Windows Forms탭에서 찾을 수 있습니다.
참고 항목
Visual Studio의 Office 개발 도구는 공유 통합 문서를 지원하지 않습니다.
VSTO 추가 기능 프로젝트의 통합 문서 호스트 항목 이해
VSTO 추가 기능 프로젝트에서는 런타임에 Excel에서 열리는 통합 문서의 Workbook 호스트 항목을 생성할 수 있습니다. Workbook 호스트 항목을 생성하려면 GetVstoObject 메서드를 사용합니다. 자세한 내용은 런타임 시 VSTO 추가 기능에서 Word 문서 및 Excel 통합 문서 확장을 참조하세요.