Element hosta arkusza

Element hosta jest typem, który rozszerza typ z podstawowego zestawu Worksheet Worksheet międzyoptykowego dla Excel. Element hosta udostępnia wszystkie te same właściwości, metody i zdarzenia jako obiekt, ale również uwidacznia dodatkowe zdarzenia i działa jako kontener dla kontrolek hosta i kontrolek Windows Worksheet Worksheet Forms.

Dotyczy: Informacje przedstawione w tym temacie dotyczą projektów na - poziomie dokumentu i dodatku VSTO - w projektach dla programu Excel. Aby uzyskać więcej informacji, zobacz dostępność funkcji według aplikacji pakietu Office i typów projektów.

W projektach na poziomie dokumentu można dodawać Worksheet elementy hosta do projektu w czasie projektowania. W VSTO projektów dodatków można generować Worksheet elementy hosta w czasie uruchamiania.

Informacje o elementach hosta arkusza w projektach na poziomie dokumentu

Podczas tworzenia projektu na poziomie dokumentu dla Excel Visual Studio automatycznie tworzy trzy Worksheet elementy hosta w projekcie. Domyślne nazwy arkuszy to Sheet1 , Sheet2 i Sheet3 . W przypadku tworzenia projektu na podstawie istniejącego skoroszytu liczba elementów hosta zależy od liczby arkuszy w skoroszycie.

Te klasy arkusza zapewniają dostęp do elementów członkowskich elementu hosta w celu wykonywania podstawowych zadań w dostosowywaniu, takich jak modyfikowanie Worksheet zawartości arkusza. Można również użyć tych klas, aby dodać kontrolki do arkuszy. Łącząc różne zestawy kontrolek i pisząc kod, można powiązać kontrolki z danymi, zbierać informacje od użytkownika i reagować na akcje użytkownika. Aby uzyskać więcej informacji, zobacz Program document-level customizations (Program dostosowań na poziomie dokumentu).

Klasy arkusza zapewniają 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 obiekt w podstawowym zestawie międzyoptykowym dla programu Excel, można również użyć tych klas, aby uzyskać dostęp do modelu obiektów Worksheet Excel. Aby uzyskać więcej informacji, zobacz omówienie Excel object model .

W projektach na poziomie dokumentu można dodać do projektu dodatkowe elementy hosta w czasie projektowania, dodając nowy arkusz do skoroszytu Worksheet w projektancie.

Zmienianie nazw arkuszy

W projekcie na poziomie dokumentu można zmienić nazwy arkuszy w projektancie Visual Studio, ale zmienia to tylko nazwę wyświetlaną arkusza. Nazwa programowa jest nadal domyślną nazwą arkusza. Jeśli zmienisz nazwę arkusza w oknie Właściwości, zostanie zmieniona tylko nazwa programowa.

Ograniczenia elementu hosta arkusza w projektach na poziomie dokumentu

Nie można tworzyć nowych Worksheet elementów hosta w czasie uruchamiania w projekcie na poziomie dokumentu. Jeśli utworzysz nowy Excel w czasie uruchamiania, będzie on typu Worksheet . Ponieważ nie jest to element hosta, nie może zawierać żadnych kontrolek hosta ani kontrolek Windows Forms. Aby uzyskać więcej informacji na temat tworzenia dokumentów w czasie uruchamiania, zobacz Temat Jak programowo dodawać nowe arkusze do skoroszytów.

Informacje o elementach hosta arkusza VSTO projektach dodatków

W projektach na poziomie aplikacji można wygenerować element hosta w czasie uruchamiania dla dowolnego arkusza, Worksheet który jest otwarty w Excel. Element hosta umożliwia dodawanie kontrolek do skojarzonego arkusza lub obsługę zdarzeń, Worksheet które nie są dostępne w Worksheet obiektach.

Aby wygenerować Worksheet element hosta, użyj GetVstoObject metody . Aby uzyskać więcej informacji, zobacz Extend Word documents and Excel workbooks in VSTO Add-ins at run time(Rozszerzanie dokumentów programu Word i VSTO w czasie uruchamiania).

Zobacz też