Udostępnij za pośrednictwem


Element hosta skoroszytu

Element Workbook hosta jest typem, który rozszerza Workbook typ z podstawowego zestawu międzyoperacyjności dla programu Excel. Element Workbook hosta udostępnia wszystkie te same właściwości, metody i zdarzenia co Workbook obiekt, ale udostępnia również dodatkowe funkcje.

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu i projektów dodatków VSTO dla programu Excel. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

W projektach na poziomie dokumentu istnieje domyślny Workbook element hosta reprezentujący skoroszyt w projekcie. W projektach dodatków VSTO można generować Workbook elementy hosta w czasie wykonywania.

Informacje o elemencie hosta skoroszytu w projektach na poziomie dokumentu

Aby uzyskać dostęp do skoroszytu w projekcie, użyj ThisWorkbook klasy . Klasa ThisWorkbook zapewnia dostęp do elementów członkowskich Workbook elementu hosta w celu wykonywania podstawowych zadań w dostosowywaniu, takich jak uruchamianie kodu po otwarciu lub zamknięciu skoroszytu. Aby uzyskać więcej informacji, zobacz Dostosowywanie na poziomie dokumentu programu.

Klasa ThisWorkbook udostępnia lokalizację, w której można rozpocząć pisanie kodu w projekcie. Ponieważ klasa udostępnia wszystkie te same właściwości, metody i zdarzenia co Workbook obiekt w podstawowym zestawie międzyoperacyjnych dla programu Excel, można również użyć ThisWorkbook do uzyskania dostępu do modelu obiektów programu Excel. Aby uzyskać więcej informacji, zobacz Omówienie modelu obiektów programu Excel.

Kliknij dwukrotnie element projektu ThisWorkbook w Eksplorator rozwiązań, aby wyświetlić projektanta skoroszytu i wyświetlić właściwości i zdarzenia skoroszytu w oknie Właściwości.

Ograniczenia elementu hosta skoroszytu w projektach na poziomie dokumentu

Projekt na poziomie dokumentu może zawierać tylko jeden Workbook element hosta (czyli klasę ThisWorkbook ). Nie można dodawać nowych Workbook elementów hosta do projektu w czasie projektowania i nie można tworzyć nowych Workbook elementów hosta w czasie wykonywania z dostosowania na poziomie dokumentu.

Jeśli tworzysz nowy skoroszyt programu Excel w czasie wykonywania, będzie to typ Workbook. Ponieważ nie jest to element hosta, nie może zawierać żadnych kontrolek hosta ani kontrolek formularzy systemu Windows. Aby uzyskać więcej informacji na temat tworzenia skoroszytów w czasie wykonywania, zobacz Instrukcje: Programowe tworzenie nowych skoroszytów.

Element Workbook hosta nie działa jako kontener dla kontrolek hosta. W związku z tym nie można dodać żadnych widocznych kontrolek do skoroszytu, ale można dodawać składniki, takie jak DataSet, aby składniki mogły być współużytkowane przez wszystkie arkusze. W projekcie na poziomie dokumentu składniki dostępne dla skoroszytu można znaleźć na karcie Składnik, karcie Dane i na karcie Wszystkie formularze systemu Windows przybornika.

Uwaga

Narzędzia programistyczne pakietu Office w programie Visual Studio nie obsługują udostępnionych skoroszytów.

Omówienie elementów hosta skoroszytu w projektach dodatków VSTO

W projektach dodatków VSTO można wygenerować Workbook element hosta w czasie wykonywania dla dowolnego skoroszytu otwartego w programie Excel. Aby wygenerować Workbook element hosta, użyj GetVstoObject metody . Aby uzyskać więcej informacji, zobacz Rozszerzanie dokumentów programu Word i skoroszytów programu Excel w dodatku VSTO w czasie wykonywania.