Przewodnik: tworzenie pierwszego dodatku VSTO dla programu Excel

  • Artykuł

W tym przewodniku wprowadzającym pokazano, jak utworzyć dodatek na poziomie aplikacji dla programu Microsoft Office Excel. Funkcje tworzone w tym rodzaju rozwiązania są dostępne dla samej aplikacji, niezależnie od tego, które skoroszyty są otwarte.

Dotyczy: informacje w tym temacie dotyczą 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.

Uwaga

Chcesz opracowywać rozwiązania, które rozszerzają środowisko pakietu Office na wiele platform? Zapoznaj się z nowym modelem dodatków pakietu Office. Dodatki pakietu Office mają niewielki rozmiar w porównaniu z dodatkami I rozwiązaniami VSTO i można je tworzyć przy użyciu niemal dowolnej technologii programowania internetowego, takiej jak HTML5, JavaScript, CSS3 i XML.

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

  • Tworzenie projektu dodatku VSTO programu Excel dla programu Excel.

  • Pisanie kodu, który używa modelu obiektów programu Excel do dodawania tekstu do skoroszytu podczas jego zapisywania.

  • Kompilowanie i uruchamianie projektu w celu jego przetestowania.

  • Czyszczenie ukończonego projektu w taki sposób, aby dodatek VSTO nie był już uruchamiany automatycznie na komputerze 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 dodatku VSTO 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 okienku szablonów rozwiń węzeł Visual C# lub Visual Basic, a następnie rozwiń węzeł Office/SharePoint.

  4. W rozwiniętym węźle Office/SharePoint wybierz węzeł Dodatki pakietu Office.

  5. Na liście szablonów projektów wybierz pozycję Dodatek programu Excel 2010 lub dodatek programu Excel 2013.

  6. W polu Nazwa wpisz FirstExcelAddIn.

  7. Kliknij przycisk OK.

    Program Visual Studio tworzy projekt FirstExcelAddIn i otwiera plik kodu ThisAddIn w edytorze.

Pisanie kodu w celu dodania tekstu do zapisanego skoroszytu

Następnie dodaj kod do pliku kodu ThisAddIn. Nowy kod używa modelu obiektów programu Excel, aby wstawić standardowy tekst w pierwszym wierszu aktywnego arkusza. Aktywny arkusz to arkusz, który jest otwarty po zapisaniu skoroszytu przez użytkownika. Domyślnie plik kodu ThisAddIn zawiera następujący wygenerowany kod:

  • Częściowa definicja ThisAddIn klasy. Ta klasa zapewnia punkt wejścia dla kodu i zapewnia dostęp do modelu obiektów programu Excel. Aby uzyskać więcej informacji, zobacz Program VSTO Add-ins (Dodatki programu VSTO). Pozostała część ThisAddIn klasy jest zdefiniowana w ukrytym pliku kodu, którego nie należy modyfikować.

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

Aby dodać wiersz tekstu do zapisanego skoroszytu

  1. W pliku kodu ThisAddIn dodaj następujący kod do ThisAddIn klasy . Nowy kod definiuje program obsługi zdarzeń dla WorkbookBeforeSave zdarzenia, który jest zgłaszany podczas zapisywania skoroszytu.

    Gdy użytkownik zapisze skoroszyt, program obsługi zdarzeń dodaje nowy tekst na początku aktywnego arkusza.

    void Application_WorkbookBeforeSave(Microsoft.Office.Interop.Excel.Workbook Wb, bool SaveAsUI, ref bool Cancel)
{
    Excel.Worksheet activeWorksheet = ((Excel.Worksheet)Application.ActiveSheet);
    Excel.Range firstRow = activeWorksheet.get_Range("A1");
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown);
    Excel.Range newFirstRow = activeWorksheet.get_Range("A1");
    newFirstRow.Value2 = "This text was added by using code";
}

  2. Jeśli używasz języka C#, dodaj następujący wymagany kod do procedury obsługi zdarzeń ThisAddIn_Startup . Ten kod służy do łączenia Application_WorkbookBeforeSave programu obsługi zdarzeń ze zdarzeniem WorkbookBeforeSave .

    this.Application.WorkbookBeforeSave += new Microsoft.Office.Interop.Excel.AppEvents_WorkbookBeforeSaveEventHandler(Application_WorkbookBeforeSave);

    Aby zmodyfikować skoroszyt po zapisaniu, w poprzednich przykładach kodu są używane następujące obiekty:

  • Pole ApplicationThisAddIn klasy . Pole Application zwraca Application obiekt, który reprezentuje bieżące wystąpienie programu Excel.

  • Wb Parametr programu obsługi zdarzeń dla WorkbookBeforeSave zdarzenia. Parametr Wb jest obiektem reprezentującym Workbook zapisany skoroszyt. Aby uzyskać więcej informacji, zobacz Omówienie modelu obiektów programu Excel.

Testowanie projektu

Aby przetestować projekt

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

    Podczas kompilowania projektu kod jest kompilowany w zestawie, który znajduje się w folderze danych wyjściowych kompilacji dla projektu. Program Visual Studio tworzy również zestaw wpisów rejestru, które umożliwiają programowi Excel odnajdywanie i ładowanie dodatku VSTO oraz konfigurowanie ustawień zabezpieczeń na komputerze deweloperów w celu włączenia uruchamiania dodatku VSTO. Aby uzyskać więcej informacji, zobacz Tworzenie rozwiązań pakietu Office.

  2. W programie Excel zapisz skoroszyt.

  3. Sprawdź, czy do skoroszytu został dodany następujący tekst.

    Ten tekst został dodany przy użyciu kodu.

  4. Zamknij program Excel.

Czyszczenie projektu

Po zakończeniu tworzenia projektu usuń zestaw dodatku VSTO, wpisy rejestru i ustawienia zabezpieczeń z komputera dewelopera. W przeciwnym razie dodatek VSTO będzie nadal działać za każdym razem, gdy otworzysz program Excel na komputerze dewelopera.

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 dodatku VSTO dla programu Excel możesz dowiedzieć się więcej o sposobie tworzenia dodatków VSTO z następujących tematów:

  • Ogólne zadania programistyczne, które można wykonywać w dodatku VSTO: Program VSTO Dodatki.

  • Zadania programistyczne specyficzne dla dodatków VSTO 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 niestandardowego okienka zadań: dostosowywanie interfejsu użytkownika pakietu Office.

  • Kompilowanie i debugowanie dodatków VSTO dla programu Excel: tworzenie rozwiązań pakietu Office.

  • Wdrażanie dodatków VSTO dla programu Excel: wdrażanie rozwiązania pakietu Office.

Powiązana zawartość