Udostępnij za pośrednictwem


Element hosta arkusza

Element Worksheet hosta jest typem, który rozszerza Worksheet typ z podstawowego zestawu międzyoperacyjności dla programu Excel. Element Worksheet hosta zawiera wszystkie te same właściwości, metody i zdarzenia co Worksheet obiekt, ale także uwidacznia dodatkowe zdarzenia i działa jako kontener dla kontrolek hosta i kontrolek Windows Forms.

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 można dodawać Worksheet elementy hosta do projektu w czasie projektowania. W projektach dodatków VSTO można generować Worksheet elementy hosta w czasie wykonywania.

Omówienie elementów hosta arkusza w projektach na poziomie dokumentu

Podczas tworzenia projektu na poziomie dokumentu dla programu Excel program Visual Studio automatycznie tworzy trzy Worksheet elementy hosta w projekcie. Domyślne nazwy arkuszy to Sheet1, Sheet2i Sheet3. Jeśli tworzysz projekt na podstawie istniejącego skoroszytu, liczba elementów hosta zależy od liczby arkuszy w skoroszycie.

Te klasy arkuszy zapewniają dostęp do elementów członkowskich Worksheet elementu hosta w celu wykonywania podstawowych zadań w dostosowywaniu, takich jak modyfikowanie zawartości arkusza. Można również użyć tych klas do dodawania kontrolek 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 Dostosowywanie na poziomie dokumentu programu.

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

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

Zmienianie nazw arkuszy

W projekcie na poziomie dokumentu można zmienić nazwy arkuszy w projektancie programu 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 , zmieni się tylko nazwa programowa.

Ograniczenia elementu hosta arkusza w projektach na poziomie dokumentu

W projekcie na poziomie dokumentu nie można tworzyć nowych Worksheet elementów hosta w czasie wykonywania. Jeśli utworzysz nowy arkusz programu Excel w czasie wykonywania, będzie to typ Worksheet. 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 dokumentów w czasie wykonywania, zobacz Instrukcje: Programowe dodawanie nowych arkuszy do skoroszytów.

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

W projektach na poziomie aplikacji można wygenerować Worksheet element hosta w czasie wykonywania dla dowolnego arkusza otwartego w programie Excel. Za pomocą Worksheet elementu hosta można dodawać kontrolki do skojarzonego arkusza lub obsługiwać zdarzenia, które nie są dostępne w Worksheet obiektach.

Aby wygenerować Worksheet 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.