Udostępnij za pośrednictwem


Wskazówki: tworzenie pierwszego dodatku na poziomie aplikacji dla programu Excel

W tym instruktażu wprowadzające pokazuje, jak utworzyć poziomu aplikacji dodatek dla programu Microsoft Office Excel.Funkcje, które można tworzyć w tego rodzaju rozwiązanie są dostępne dla samej aplikacji, niezależnie od tego, które są otwarte skoroszyty.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie aplikacji 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 dodatek programu Excel dla programu Excel.

  • Pisać kod, który używa modelu obiektu programu Excel, aby dodać tekst do skoroszytu, po zapisaniu go.

  • Tworzenie i uruchamianie projektu, aby go przetestować.

  • Oczyszczanie zakończonych projektów tak, że dodatek nie działa 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 Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.

Wymagania wstępne

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

Tworzenie projektu

Tworzenie nowego programu Excel dodatek projektu 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, Excel 2010 Add-in lub dodatku 2013 Excel.

  6. W Nazwa wpisz FirstExcelAddIn.

  7. Kliknij przycisk OK.

    Visual StudioTworzy FirstExcelAddIn projekt i otwiera plik ThisAddIn kod w edytorze.

Pisanie kodu, aby dodać tekst do zapisanego skoroszytu

Następnie należy dodać kod do pliku kod ThisAddIn.Nowy kod używa modelu obiektu programu Excel, aby wstawić tekst standardowy w pierwszym wierszu aktywnego arkusza.Aktywnego arkusza jest arkusz, który jest otwarty, gdy użytkownik zapisuje skoroszyt.Domyślnie plik kodu ThisAddIn zawiera następujący kod wygenerowany:

  • Częściowe definicja ThisAddIn klasy.Ta klasa zapewnia punktu wejścia dla kodu i zapewnia dostęp do modelu obiektu programu Excel.Aby uzyskać więcej informacji, zobacz Programowanie dodatków na poziomie aplikacji.Pozostałą część ThisAddIn klasa jest zdefiniowana w pliku ukrytego kodu, który nie należy modyfikować.

  • ThisAddIn_Startup i ThisAddIn_Shutdown obsługi zdarzeń.Te programy obsługi zdarzeń są wywoływane, gdy program Excel ładuje i wyładowuje dodatku.Zainicjowanie dodatku po załadowaniu i oczyścić zasoby używane przez dodatku, gdy jest zwalniany, należy użyć te programy obsługi zdarzeń.Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

Aby dodać wiersz tekstu do zapisanego skoroszytu

  1. W pliku ThisAddIn kodu, Dodaj następujący kod do ThisAddIn klasy.Nowy kod definiuje obsługi zdarzenia WorkbookBeforeSave zdarzenie, które jest wywoływane, gdy skoroszyt jest zapisywany.

    Gdy użytkownik zapisuje skoroszyt, program obsługi zdarzeń dodaje nowy tekst w chwili rozpoczęcia aktywnego arkusza.

    Private Sub Application_WorkbookBeforeSave(ByVal Wb As Microsoft.Office.Interop.Excel.Workbook, ByVal SaveAsUI As Boolean, ByRef Cancel As Boolean) Handles Application.WorkbookBeforeSave
        Dim activeWorksheet As Excel.Worksheet = CType(Application.ActiveSheet, Excel.Worksheet)
        Dim firstRow As Excel.Range = activeWorksheet.Range("A1")
        firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown)
        Dim newFirstRow As Excel.Range = activeWorksheet.Range("A1")
        newFirstRow.Value2 = "This text was added by using code" 
    End Sub
    
    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 kod wymagany do ThisAddIn_Startup programu obsługi zdarzeń.Kod ten jest używany do łączenia z Application_WorkbookBeforeSave obsługi zdarzeń z WorkbookBeforeSave zdarzenie.

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

Aby zmodyfikować skoroszyt, po jej zapisaniu, poprzednich przykładach kodu należy następujące obiekty:

  • Application Pole ThisAddIn klasy.Application Zwraca wartość w polu Application obiekt, który reprezentuje w bieżącym wystąpieniu programu Excel.

  • Wb Parametr programu obsługi zdarzeń dla WorkbookBeforeSave zdarzenie.Wb Parametr jest Workbook obiekt, który reprezentuje zapisany skoroszyt.Aby uzyskać więcej informacji, zobacz Model obiektu Excel ― Omówienie.

Testowanie projektu

Aby przetestować projekt

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

    Podczas budowania projektu, kod jest skompilowany w zespół, który znajduje się w folderze wyjściowym kompilacji projektu.Visual Studio również tworzy zestaw wpisów rejestru, które umożliwiają Excel odkryć i załadować dodatek i konfiguruje ustawienia zabezpieczeń na komputerze deweloperskim, aby włączyć dodatek do uruchomienia.Aby uzyskać więcej informacji, zobacz Kompilowanie rozwiązań pakietu Office.

  2. W programie Excel Zapisz skoroszyt.

  3. Sprawdź, że następujący tekst dodaje się w skoroszycie.

    Tekst ten został dodany za pomocą kodu.

  4. Zamknij program Excel.

Czyszczenie projektu

Po zakończeniu opracowanie projektu,-w zestawie, wpisy rejestru i ustawienia zabezpieczeń należy usunąć z komputera rozwoju.W przeciwnym razie dodatek będzie wykonać za każdym razem po otwarciu programu Excel na komputerze dewelopera.

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 podstawowy poziom aplikacji dodatek dla programu Excel, można dowiedzieć się więcej o opracowanie dodatki z tych tematów:

Zobacz też

Koncepcje

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

Inne zasoby

Rozwiązania programu Excel

Programowanie dodatków na poziomie aplikacji

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