Przewodnik: tworzenie pierwszego dostosowania na poziomie dokumentu dla programu Excel

  • Artykuł

W tym przewodniku wprowadzającym pokazano, jak utworzyć dostosowanie na poziomie dokumentu dla programu Microsoft Office Excel. Funkcje tworzone w tym rodzaju rozwiązania są dostępne tylko po otwarciu określonego skoroszytu. Nie można użyć dostosowania na poziomie dokumentu, aby wprowadzić zmiany w całej aplikacji, na przykład wyświetlając nową kartę wstążki po otwarciu dowolnego skoroszytu.

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

W instruktażu przedstawiono następujące zagadnienia:

  • Tworzenie projektu skoroszytu programu Excel.

  • Dodawanie tekstu do arkusza hostowanego w projektancie programu Visual Studio.

  • Pisanie kodu korzystającego z modelu obiektów programu Excel w celu dodania tekstu do dostosowanego arkusza po jego otwarciu.

  • Kompilowanie i uruchamianie projektu w celu jego przetestowania.

  • Czyszczenie ukończonego projektu w celu usunięcia niepotrzebnych plików kompilacji i ustawień zabezpieczeń z komputera dewelopera.

    Uwaga

    Na komputerze w poniższych instrukcjach mogą być wyświetlane inne nazwy i lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio. Te elementy są określane przez numer wersji Visual Studio oraz twoje ustawienia. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE.

Wymagania wstępne

Następujące składniki są wymagane do przeprowadzenia tego instruktażu:

Tworzenie projektu

Aby utworzyć nowy projekt skoroszytu programu Excel w programie Visual Studio

  1. Uruchom program Visual Studio.

  2. W menu Plik wskaż polecenie Nowy, a następnie kliknij pozycję Projekt.

  3. W oknie dialogowym Tworzenie nowego projektu wybierz projekt Skoroszyt programu Excel VSTO.

    Uwaga

    Szablony można również wyszukać, wpisując nazwę produktu pakietu Office w polu tekstowym Wyszukaj w górnej części okna dialogowego Tworzenie nowego projektu . Na przykład wpisanie w programie Excel spowoduje wyświetlenie wszystkich szablonów projektów dla programu Excel. Listę szablonów można również filtrować, aby wyświetlić tylko szablony pakietu Office, wybierając pozycję Office w polu listy rozwijanej Typ projektu. Aby uzyskać więcej informacji, zobacz Tworzenie nowego projektu w programie Visual Studio.

  4. Kliknij przycisk Dalej.

  5. Wpisz FirstWorkbookCustomization w polu Nazwa w oknie dialogowym Konfigurowanie nowego projektu i kliknij przycisk Utwórz.

  6. Wybierz pozycję Utwórz nowy dokument z Kreatora projektu Visual Studio Tools dla pakietu Office, a następnie kliknij przycisk OK.

    • Program Visual Studio tworzy projekt FirstWorkbookCustomization i dodaje następujące pliki do projektu.

    • FirstWorkbookCustomization.xlsx — reprezentuje skoroszyt programu Excel w projekcie. Zawiera wszystkie arkusze i wykresy.

    • Arkusz1 (plik vb dla języka Visual Basic lub .cs dla języka Visual C#) — arkusz zawierający powierzchnię projektową i kod pierwszego arkusza w skoroszycie. Aby uzyskać więcej informacji, zobacz Element hosta arkusza.

    • Arkusz2 (plik vb dla języka Visual Basic lub cs dla języka Visual C#) — arkusz zawierający powierzchnię projektową i kod drugiego arkusza w skoroszycie.

    • Arkusz3 (plik vb dla języka Visual Basic lub .cs dla języka Visual C#) — arkusz zawierający powierzchnię projektową i kod trzeciego arkusza w skoroszycie.

    • ThisWorkbook (plik vb dla języka Visual Basic lub .cs dla języka Visual C#) — zawiera powierzchnię projektową i kod dostosowywania na poziomie skoroszytu. Aby uzyskać więcej informacji, zobacz Element hosta skoroszytu.

      Plik kodu Sheet1 jest otwierany automatycznie w projektancie.

Zamknij i otwórz ponownie arkusze w projektancie

Jeśli podczas tworzenia projektu celowo lub przypadkowo zamkniesz skoroszyt lub arkusz w projektancie, możesz go ponownie otworzyć.

Aby zamknąć i ponownie otworzyć arkusz w projektancie

  1. Zamknij skoroszyt, klikając przycisk Zamknij (X) okna projektanta.

  2. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy plik kodu Sheet1, a następnie kliknij pozycję Wyświetl Projektant.

    - lub -

    W Eksplorator rozwiązań kliknij dwukrotnie plik kodu Sheet1.

Dodawanie tekstu do arkusza w projektancie

Interfejs użytkownika (UI) dostosowywania można zaprojektować, modyfikując arkusz otwarty w projektancie. Możesz na przykład dodać tekst do komórek, zastosować formuły lub dodać kontrolki programu Excel. Aby uzyskać więcej informacji na temat korzystania z projektanta, zobacz Projekty pakietu Office w środowisku programu Visual Studio.

Aby dodać tekst do arkusza przy użyciu projektanta

  1. W arkuszu otwartym w projektancie wybierz komórkę A1, a następnie wpisz następujący tekst.

    Ten tekst został dodany przy użyciu projektanta.

Ostrzeżenie

Jeśli dodasz ten wiersz tekstu do komórki A2, zostanie on zastąpiony przez inny kod w tym przykładzie.

Programowe dodawanie tekstu do arkusza

Następnie dodaj kod do pliku kodu Sheet1. Nowy kod używa modelu obiektów programu Excel do dodania drugiego wiersza tekstu do skoroszytu. Domyślnie plik kodu Sheet1 zawiera następujący wygenerowany kod:

  • Częściowa definicja Sheet1 klasy, która reprezentuje model programowania arkusza i zapewnia dostęp do modelu obiektów programu Excel. Aby uzyskać więcej informacji, omówienie elementu hosta arkusza i modelu obiektów programu Word. Pozostała część Sheet1 klasy jest zdefiniowana w ukrytym pliku kodu, którego nie należy modyfikować.

  • Programy obsługi zdarzeń Sheet1_Startup i Sheet1_Shutdown . Te programy obsługi zdarzeń są wywoływane, gdy program Excel ładuje i zwalnia dostosowanie. Użyj tych procedur obsługi zdarzeń, aby zainicjować dostosowywanie podczas ładowania i wyczyścić zasoby używane przez dostosowanie podczas jego zwolnienia. Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

Aby dodać drugi wiersz tekstu do arkusza przy użyciu kodu

  1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy pozycję Arkusz1, a następnie kliknij polecenie Wyświetl kod.

    Plik kodu zostanie otwarty w programie Visual Studio.

  2. Zastąp Sheet1_Startup program obsługi zdarzeń następującym kodem. Po otwarciu arkusza Sheet1 ten kod dodaje drugi wiersz tekstu do arkusza.

    private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.NamedRange nr =
        this.Controls.AddNamedRange(this.Range["A2"], "NamedRange1");
    nr.Value2 = "This text was added by using code";
}

Testowanie projektu

Aby przetestować skoroszyt

  1. Naciśnij klawisz F5 , aby skompilować i uruchomić projekt.

    Podczas kompilowania projektu kod jest kompilowany w zestawie skojarzonym ze skoroszytem. Program Visual Studio umieszcza kopię skoroszytu i zestawu w folderze danych wyjściowych kompilacji dla projektu i konfiguruje ustawienia zabezpieczeń na komputerze dewelopera, aby umożliwić uruchamianie dostosowania. Aby uzyskać więcej informacji, zobacz Tworzenie rozwiązań pakietu Office.

  2. W skoroszycie sprawdź, czy widzisz następujący tekst.

    Ten tekst został dodany przy użyciu projektanta.

    Ten tekst został dodany przy użyciu kodu.

  3. Zamknij skoroszyt.

Czyszczenie projektu

Po zakończeniu tworzenia projektu należy usunąć pliki w folderze wyjściowym kompilacji i ustawienia zabezpieczeń utworzone przez proces kompilacji.

Aby wyczyścić ukończony projekt na komputerze dewelopera

  1. W programie Visual Studio w menu Kompilacja kliknij pozycję Wyczyść rozwiązanie.

Następne kroki

Po utworzeniu podstawowego dostosowywania na poziomie dokumentu dla programu Excel możesz dowiedzieć się więcej na temat opracowywania dostosowań z następujących tematów:

  • Ogólne zadania programistyczne, które można wykonać w dostosowaniach na poziomie dokumentu: Dostosowania na poziomie dokumentu programu.

  • Zadania programistyczne specyficzne dla dostosowań na poziomie dokumentu dla programu Excel: rozwiązania programu Excel.

  • Korzystanie z modelu obiektów programu Excel: Omówienie modelu obiektów programu Excel.

  • Dostosowywanie interfejsu użytkownika programu Excel, na przykład przez dodanie karty niestandardowej do wstążki lub utworzenie własnego okienka akcji: dostosowywanie interfejsu użytkownika pakietu Office.

  • Używanie rozszerzonych obiektów programu Excel udostępnianych przez narzędzia programistyczne pakietu Office w programie Visual Studio do wykonywania zadań, które nie są możliwe przy użyciu modelu obiektów programu Excel (na przykład hostowania zarządzanych kontrolek na dokumentach i wiązania kontrolek programu Excel z danymi przy użyciu modelu powiązania danych formularzy systemu Windows): Automatyzowanie programu Excel przy użyciu obiektów rozszerzonych.

  • Kompilowanie i debugowanie dostosowań na poziomie dokumentu dla programu Excel: tworzenie rozwiązań pakietu Office.

  • Wdrażanie dostosowań na poziomie dokumentu dla programu Excel: wdrażanie rozwiązania pakietu Office.

Powiązana zawartość