Przewodnik: Tworzenie pierwszego dostosowania na poziomie dokumentu dla Excel

W tym przewodniku wprowadzającym pokazano, jak utworzyć dostosowanie na poziomie dokumentu dla Microsoft Office Excel. Funkcje, które tworzysz w tego typu rozwiązaniu, są dostępne tylko wtedy, gdy jest otwarty określony skoroszyt. 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, gdy dowolny skoroszyt jest otwarty.

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

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

  • Tworzenie projektu Excel skoroszytu.

  • Dodawanie tekstu do arkusza, który jest hostowany w Visual Studio projektanta.

  • Pisanie kodu, który używa modelu obiektów Excel do dodawania tekstu do dostosowanego arkusza po jego otwarciu.

  • Budowania i uruchamiania projektu w celu przetestowania go.

  • 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 Excel skoroszytu w programie Visual Studio

  1. Uruchom Visual Studio .

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

  1. W okienku szablonów rozwiń pozycję Visual C# lub Visual Basic, a następnie rozwiń pozycję Office/SharePoint.

  2. W rozwiniętym węźle Office/SharePoint wybierz węzeł VSTO dodatki.

  3. Na liście szablonów projektów wybierz projekt Excel VSTO skoroszytu.

  4. W polu Nazwa wpisz FirstWorkbookCustomization.

  5. Kliknij przycisk OK.

  6. Wybierz pozycję Utwórz nowy dokument w Kreatorze Visual Studio Tools dla pakietu Office Project, a następnie kliknij przycisk OK.

  1. W oknie dialogowym Tworzenie nowego Project wybierz projekt Excel VSTO skoroszytu.

    Uwaga

    Możesz również wyszukać szablony, wpisując nazwę produktu Office w polu tekstowym Wyszukaj w górnej części okna dialogowego Tworzenie nowego Project aplikacji. Na przykład wpisanie Excel spowoduje wyświetlanie wszystkich szablonów projektu dla Excel. Możesz również filtrować listę szablonów, aby wyświetlić tylko szablony dla programu Office, wybierając pozycję Office w polu listy rozwijanej Project typ. Aby uzyskać więcej informacji, zobacz Tworzenie nowego projektu w Visual Studio.

  2. Kliknij przycisk Dalej.

  3. Wpisz FirstWorkbookCustomization w polu Nazwa w oknie dialogowym Konfigurowanie nowego projektu i kliknij pozycję Utwórz.

  4. Wybierz pozycję Utwórz nowy dokument w Kreatorze Visual Studio Tools dla pakietu Office Project, a następnie kliknij przycisk OK.

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

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

  • Sheet1 (plik vb dla Visual Basic lub cs dla Visual C#) — arkusz, który zapewnia powierzchnię projektową i kod pierwszego arkusza w skoroszycie. Aby uzyskać więcej informacji, zobacz Arkusz elementu hosta.

  • Sheet2 (plik vb dla Visual Basic lub cs dla Visual C#) — arkusz, który zapewnia powierzchnię projektową i kod drugiego arkusza w skoroszycie.

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

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

    Plik kodu Sheet1 jest otwierany automatycznie w projektancie.

Zamykanie i ponowne otwieranie arkuszy w projektancie

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

Aby zamknąć i ponownie otworzyć arkusz w projektancie

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

  2. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy plik kodu Sheet1, a następnie kliknij Projektant widoków.

    - lub —

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

Dodawanie tekstu do arkusza w projektancie

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

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 Excel, aby dodać drugi wiersz tekstu do skoroszytu. Domyślnie plik kodu Sheet1 zawiera następujący wygenerowany kod:

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

  • Programy Sheet1_Startup Sheet1_Shutdown obsługi zdarzeń i . Te procedury obsługi zdarzeń są wywoływane, Excel ładuje i zwalnia dostosowanie. Te procedury obsługi zdarzeń służą do inicjowania dostosowania podczas ładowania oraz do czyszczenia zasobów używanych przez dostosowanie po jego zwolniniu. Aby uzyskać więcej informacji, zobacz Zdarzenia w Office projektach.

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 Visual Studio.

  2. Zastąp program Sheet1_Startup 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";
    }
    
    Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
        Dim nr As Microsoft.Office.Tools.Excel.NamedRange = _
            Me.Controls.AddNamedRange(Me.Range("A2"), "NamedRange1")
        nr.Value2 = "This text was added by using code"
    End Sub
    

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. 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 Build Office solutions (Tworzenie Office rozwiązań).

  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 z folderu wyjściowego kompilacji oraz ustawienia zabezpieczeń utworzone w procesie kompilacji.

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

  1. W Visual Studio menu Build (Kompilacja) kliknij pozycję Clean Solution (Wyczyść rozwiązanie).

Następne kroki

Teraz, po utworzeniu podstawowego dostosowania na poziomie dokumentu dla Excel, możesz dowiedzieć się więcej na temat sposobu opracowywania dostosowań z tych tematów:

  • Ogólne zadania programistyczne, które można wykonywać w dostosowaniach na poziomie dokumentu: Programowanie dostosowań na poziomie dokumentu.

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

  • Korzystanie z modelu obiektów Excel: Excel modelu obiektów .

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

  • Używanie rozszerzonych obiektów Excel dostarczanych przez narzędzia programowe programu Office w programie Visual Studio do wykonywania zadań, które nie są możliwe przy użyciu modelu obiektów Excel (na przykład hostowanie kontrolek zarządzanych w dokumentach i powiązanie kontrolek Excel z danymi przy użyciu modelu powiązania danych formularzy Windows Forms): automatyzacja usługi Excel przy użyciu obiektów rozszerzonych.

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

  • Wdrażanie dostosowań na poziomie dokumentu dla Excel: wdrażanie Office dokumentów.

Zobacz też