Wskazówki: tworzenie pierwszego dostosowania na poziomie dokumentu dla programu Excel

  • Artykuł

W tym instruktażu wprowadzające pokazuje, jak utworzyć dostosowywania poziomie dokumentu dla programu Microsoft Office Excel.Funkcje, które można tworzyć w tego rodzaju rozwiązanie są dostępne tylko wtedy, gdy określony skoroszyt jest otwarty.Nie umożliwia dostosowania poziomu dokumentu do wprowadzania zmian w całej aplikacji, na przykład wyświetlanie na nowej karcie wstążki, gdy skoroszyt jest otwarty.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu obsługiwanych w programach Excel 2013 i Excel 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.

W tym instruktażu przedstawiono następujące zadania:

  • Tworzenie projektu skoroszytu programu Excel.

  • Dodawanie tekstu do arkusza, który jest obsługiwany w programie Visual Studio designer.

  • Pisanie kodu, który używa modelu obiektu programu Excel, aby dodać tekst do dostosowanego arkusza po jego otwarciu.

  • Tworzenie i uruchamianie projektu, aby go przetestować.

  • Oczyszczanie zakończonych projektów, aby usunąć budować niepotrzebne pliki i ustawienia zabezpieczeń na komputerze projektowym.

[!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 Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.

Wymagania wstępne

Potrzebne do przeprowadzenia tego instruktażu następujące składniki:

Tworzenie projektu

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

  1. Start Visual Studio.

  2. Na pliku menu, wskaż Nowa, a następnie kliknij przycisk Projekt.

  3. W okienku szablony, rozwiń węzeł Visual C# lub programu Visual Basic, a następnie rozwiń węzeł Office i SharePoint.

  4. W obszarze rozszerzony Office i SharePoint węzła, zaznacz Dodatki pakietu Office węzła.

  5. Zaznacz na liście szablonów projektu, Skoroszyt programu Excel 2010 lub Skoroszytu programu Excel 2013.

  6. W Nazwa wpisz FirstWorkbookCustomization.

  7. Kliknij przycisk OK.

    Visual Studio Tools for Office Project kreatora otwiera.

  8. Wybierz Utwórz nowy dokumenti kliknij przycisk OK.

    • Visual StudioTworzy FirstWorkbookCustomization projektu i dodaje następujące pliki do projektu.

    • FirstWorkbookCustomizationxlsx - reprezentuje skoroszytu programu Excel w projekcie.Zawiera wszystkie arkuszy i wykresów.

    • Arkusz1 (.vb pliku dla pliku cs dla Visual C# lub Visual Basic) - arkusza, który zapewnia na powierzchnię projektu i kodu na pierwszym arkuszu w skoroszycie.Aby uzyskać więcej informacji, zobacz Element hosta arkusza.

    • Arkusz2 (.vb pliku dla pliku cs dla Visual C# lub Visual Basic) - arkusz, dostarczający na powierzchnię projektu i kodu dla drugiego arkusza w skoroszycie.

    • Arkusz3 (.vb pliku dla pliku cs dla Visual C# lub Visual Basic) - arkusz, dostarczający na powierzchnię projektu i kodu dla trzeciego arkusza w skoroszycie.

    • Ten skoroszyt (plik .vb dla języka Visual Basic) lub plik CS dla Visual C# - zawiera na powierzchnię projektu i kodu dla dostosowania skoroszytu.Aby uzyskać więcej informacji, zobacz Element hosta skoroszytu.

    Arkusz1 pliku kod zostanie automatycznie otwarty w projektancie.

Zamknięcie i ponowne otwarcie arkuszy w Projektancie

Jeśli celowo lub przypadkowo zamknąć skoroszyt lub arkusz w Projektancie podczas opracowywania projektu, można go ponownie otworzyć.

Zamknąć i ponownie otworzyć arkusz w Projektancie

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

  2. W Solution Explorer, kliknij prawym przyciskiem myszy Arkusz1 kod pliku, a następnie kliknij przycisk Projektanta widoku.

    - lub -

    W Solution Explorer, kliknij dwukrotnie Arkusz1 kod pliku.

Dodawanie tekstu do arkusza w Projektancie

Modyfikując arkusza, który jest otwarty w projektancie, można zaprojektować interfejs użytkownika (UI) z opcji dostosowania.Na przykład dodać tekst do komórek, zastosowanie formuł lub dodawanie formantów programu Excel.Aby uzyskać więcej informacji na temat używania projektanta, zobacz Projekty pakietu Office w środowisku Visual Studio.

Aby dodać tekst do arkusza przy użyciu projektanta

  • W arkuszu, który jest otwarty w projektancie, zaznacz komórkę A1, a następnie wpisz następujący tekst.

    Tekst ten został dodany za pomocą projektanta.

Informacje dotyczące przestrogiPrzestroga

Czy dodać ten wiersz tekstu do komórki A2, zostanie on zastąpiony przez inny kod w tym przykładzie.

Dodawanie tekstu do arkusza programowo

Następnie należy dodać kod do pliku kod Arkusz1.Nowy kod używa modelu obiektu programu Excel, aby dodać drugi wiersz tekstu w skoroszycie.Domyślnie Arkusz1 pliku kodu zawiera wygenerowany następujący kod:

  • Częściowe definicja Sheet1 klasy, która reprezentuje model programowania arkusza i zapewnia dostęp do modelu obiektu programu Excel.Aby uzyskać więcej informacji Element hosta arkusza i Model obiektu Word — Omówienie.Pozostałą część Sheet1 klasa jest zdefiniowana w pliku ukrytego kodu, który nie należy modyfikować.

  • Sheet1_Startup i Sheet1_Shutdown obsługi zdarzeń.Te programy obsługi zdarzeń są wywoływane, gdy program Excel ładuje i wyładowuje dostosowań.Użyj tych programów obsługi zdarzeń zainicjować dostosowań po załadowaniu i oczyścić zasoby używane przez użytkownika dostosowywania, gdy jest zwalniany.Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

Aby dodać drugi wiersz tekstu w arkuszu przy użyciu kodu

  1. W Solution Explorer, kliknij prawym przyciskiem myszy Arkusz1, a następnie kliknij przycisk Widok Kod.

    Otwiera plik kodu w programie Visual Studio.

  2. Zamień Sheet1_Startup obsługi zdarzeń z następującego kodu.Po otwarciu Arkusz1, ten kod dodaje drugi wiersz tekstu w arkuszu.

    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

    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ć swój skoroszyt

  1. Naciśnij F5 Aby skompilować i uruchomić projekt.

    Podczas budowania projektu, kod jest skompilowany do złożenia, który jest skojarzony ze skoroszytem.Visual Studio umieszcza kopię skoroszytu i zgromadzenia w docelowym folderze kompilacji projektu i konfiguruje ustawienia zabezpieczeń na komputerze deweloperskim, aby włączyć dostosowania do uruchomienia.Aby uzyskać więcej informacji, zobacz Kompilowanie rozwiązań pakietu Office.

  2. W skoroszycie należy sprawdzić, że aby zobaczyć następujący tekst.

    Tekst ten został dodany za pomocą projektanta.

    Tekst ten został dodany za pomocą kodu.

  3. Zamknij skoroszyt.

Czyszczenie projektu

Po zakończeniu opracowanie projektu, należy usunąć pliki w folderze wyjściowym budować i ustawienia zabezpieczeń, utworzonych przez proces budowania.

Aby oczyścić zakończonych projektów na komputerze dewelopera

  • W programie Visual Studio na budować menu, kliknij przycisk Rozwiązanie.

Następne kroki

Teraz, że utworzono podstawowe dostosowania poziomie dokumentu dla programu Excel, można dowiedzieć się więcej o opracowanie dostosowania następujących tematów:

Zobacz też

Koncepcje

Rozwój rozwiązań Office ― Omówienie

Automatyzowanie programu Excel za pomocą obiektów rozszerzonych

Inne zasoby

Rozwiązania programu Excel

Programowanie dostosowań na poziome dokumentu

Model obiektu Excel ― Omówienie

Dostosowywanie interfejsu użytkownika pakietu Office

Kompilowanie rozwiązań pakietu Office

Wdrażanie rozwiązania do pakietu Office

Szablony projektów pakietu Office ― Omówienie