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

Artykuł
06/10/2015

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:

Edycja programu Visual Studio 2013, która oferuje narzędzia deweloperskie pakietu Microsoft Office. Aby uzyskać więcej informacji, zobacz Konfigurowanie komputera do opracowywania rozwiązań pakietu Office.
Excel 2013or Excel 2010.

Tworzenie projektu

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

Start Visual Studio.
Na pliku menu, wskaż Nowa, a następnie kliknij przycisk Projekt.
W okienku szablony, rozwiń węzeł Visual C# lub programu Visual Basic, a następnie rozwiń węzeł Office i SharePoint.
W obszarze rozszerzony Office i SharePoint węzła, zaznacz Dodatki pakietu Office węzła.
Zaznacz na liście szablonów projektu, Skoroszyt programu Excel 2010 lub Skoroszytu programu Excel 2013.
W Nazwa wpisz FirstWorkbookCustomization.
Kliknij przycisk OK.

Visual Studio Tools for Office Project kreatora otwiera.
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

Zamknij skoroszyt, klikając Zamknij przycisk (X) w oknie projektanta.
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.

Przestroga
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

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

Otwiera plik kodu w programie Visual Studio.

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

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.
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.
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:

Ogólnych zadań programistycznych, które można wykonywać w dostosowań na poziomie dokumentu: Programowanie dostosowań na poziome dokumentu.
Zadania programistyczne, które są specyficzne dla dostosowania poziomie dokumentu dla programu Excel: Rozwiązania programu Excel.
Za pomocą modelu obiektów programu Excel: Model obiektu Excel ― Omówienie.
Dostosowywanie interfejsu użytkownika programu Excel, na przykład przez dodanie niestandardowych kartę do Wstążki lub stworzenie okienka akcji: Dostosowywanie interfejsu użytkownika pakietu Office.
Za pomocą rozszerzone obiektów programu Excel, świadczone przez Biuro narzędzia programistyczne w programie Visual Studio do wykonywania zadań, które nie są możliwe przy użyciu modelu obiektowego programu Excel (na przykład hosting zarządzany kontrole dokumentów i powiązanie formantów programu Excel do danych przy użyciu modelu wiązania danych Windows Forms): Automatyzowanie programu Excel za pomocą obiektów rozszerzonych.
Budowanie i debugowanie dostosowania poziomie dokumentu dla programu Excel: Kompilowanie rozwiązań pakietu Office.
Wdrażanie dostosowania poziomie dokumentu dla programu Excel: Wdrażanie rozwiązania do pakietu Office.