Zdarzenia w projektach pakietu Office
Każdy szablon projektu pakietu Office automatycznie generuje kilka obsługi zdarzeń.Programy obsługi zdarzeń na poziomie dokumentu dostosowania różnią się nieco od obsługi zdarzeń na poziomie aplikacji dodatków.
Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu i aplikacji obsługiwanych w pakietach Office 2013 i Office 2010. Zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.
Projektów na poziomie dokumentu
Visual Studio zawiera wygenerowany kod, za nowe lub istniejące dokumenty lub arkuszy w poziomie dokumentu dostosowań.Ten kod wywołuje dwóch różnych zdarzeń: Startup i Shutdown.
Zdarzenia uruchamiania
Startup Zdarzenie jest wywoływane dla każdego z elementów host (dokument, skoroszyt lub arkusz) po działa dokumentu i uruchomieniu kodu inicjowania w zestawie.To jest ostatnia rzecz do uruchomienia w konstruktorze klasy, że kod jest uruchomiony w.Aby uzyskać więcej informacji na temat elementów hosta, zobacz Przegląd obiektów hosta i formantów hosta.
Podczas tworzenia projektu na poziomie dokumentu, Visual Studio tworzy programy obsługi zdarzeń dla Startup zdarzenia w plikach wygenerowany kod:
Dla projektów programu Microsoft Office Word, program obsługi zdarzeń o nazwie ThisDocument_Startup.
Dla projektów programu Microsoft Office Excel programy obsługi zdarzeń mają następujące nazwy:
Sheet1_Startup
Sheet2_Startup
Sheet3_Startup
ThisWorkbook_Startup
Zdarzenia zamknięcia systemu
Shutdown Zdarzenie jest wywoływane dla każdego z elementów host (dokument lub arkusz) kiedy domena aplikacji, ładowany do kodu ma zamiar zwolnić.To jest ostatnia rzecz do wywołania w klasie, jak to zwalnia.
Podczas tworzenia projektu na poziomie dokumentu, Visual Studio tworzy programy obsługi zdarzeń dla Shutdown zdarzenia w plikach wygenerowany kod:
Dla projektów programu Microsoft Office Word, program obsługi zdarzeń o nazwie ThisDocument_Shutdown.
Dla projektów programu Microsoft Office Excel programy obsługi zdarzeń mają następujące nazwy:
Sheet1_Shutdown
Sheet2_Shutdown
Sheet3_Shutdown
ThisWorkbook_Shutdown
[!UWAGA]
Nie usuwaj programowo formantów podczas Shutdown obsługi zdarzenia dokumentu.Elementy interfejsu użytkownika dokumentu nie są już dostępne podczas Shutdown zdarzenie.Jeśli chcesz usunąć formanty, przed zamknięciem aplikacji, Dodaj kod do obsługi innego zdarzenia, takie jak BeforeClose lub BeforeSave.
Deklaracje metod obsługi zdarzeń
Co deklaracja metody obsługi zdarzenia ma te same argumenty przekazywane do niej: sender i e.W programie Excel sender argument odnosi się do arkusza, takich jak Sheet1 lub Sheet2; w programie Word sender argument odnosi się do dokumentu.e Argument odnosi się do standardowych argumenty dla zdarzenia, które nie są używane w tym przypadku.
Poniższy przykład kodu pokazuje domyślne programy obsługi zdarzeń w projektów na poziomie dokumentu dla programu Word.
Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Startup
End Sub
Private Sub ThisDocument_Shutdown(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Shutdown
End Sub
private void ThisDocument_Startup(object sender, System.EventArgs e)
{
}
private void ThisDocument_Shutdown(object sender, System.EventArgs e)
{
}
Poniższy przykład kodu pokazuje domyślne programy obsługi zdarzeń w projektów na poziomie dokumentu dla programu Excel.
[!UWAGA]
Poniższy przykład kodu pokazuje programy obsługi zdarzeń w Sheet1 klasy.Nazwy obsługi zdarzenia w innych klas pozycji hosta odpowiada nazwie klasy.Na przykład w Sheet2 klasy, Startup programu obsługi zdarzeń o nazwie Sheet2_Startup.W ThisWorkbook klasy, Startup programu obsługi zdarzeń o nazwie ThisWorkbook_Startup.
Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Startup
End Sub
Private Sub Sheet1_Shutdown(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Shutdown
End Sub
private void Sheet1_Startup(object sender, System.EventArgs e)
{
}
private void Sheet1_Shutdown(object sender, System.EventArgs e)
{
}
Kolejność zdarzeń z poziomu dokumentu programu Excel projektów
Startup Programy obsługi zdarzeń w projektach programu Excel są nazywane w następującej kolejności:
ThisWorkbook_Startup.
Sheet1_Startup.
Sheet2_Startup.
Sheet3_Startup.
Inne arkusze w kolejności.
Shutdown Programy obsługi zdarzeń w roztworze skoroszytu są nazywane w następującej kolejności:
ThisWorkbook_Shutdown.
Sheet1_Shutdown.
Sheet2_Shutdown.
Sheet3_Shutdown.
Inne arkusze w kolejności.
Kolejność jest określona, gdy projekt jest skompilowany.Jeśli użytkownik zmienia rozmieszczenie arkusze w czasie wykonywania, nie zmienia kolejności, że zdarzenia są wywoływane przy następnym skoroszyt jest otwarty lub zamknięty.
Projektów na poziomie aplikacji
Visual Studio zawiera wygenerowany kod w poziomie aplikacji dodatków.Ten kod wywołuje dwóch różnych zdarzeń: Startup i Shutdown.
Zdarzenia uruchamiania
Startup Zdarzenie jest wywoływane po dodatek jest załadowany i uruchomieniu kodu inicjowania w zestawie.To zdarzenie jest obsługiwane przez ThisAddIn_Startup metoda w pliku wygenerowanego kodu.
Kod w ThisAddIn_Startup programu obsługi zdarzeń jest pierwszy kod użytkownika, aby uruchomić, chyba, że dodatek zastępuje RequestComAddInAutomationService metoda.W tym przypadku ThisAddIn_Startup programu obsługi zdarzeń nazywa się po RequestComAddInAutomationService.
Nie należy dodawać kod w ThisAdd-In_Startup programu obsługi zdarzeń, jeśli kod wymaga dokument być otwarty.Zamiast tego należy dodać kod do zdarzenia, które wywołuje aplikacji pakietu Office, gdy użytkownik tworzy lub otwiera dokument.Aby uzyskać więcej informacji, zobacz Uzyskiwanie dostępu do dokumentu podczas uruchamiania aplikacji pakietu Office.
Aby uzyskać więcej informacji na temat sekwencji rozruchowej dodatków, zobacz Architektura dodatków na poziomie aplikacji.
Zdarzenia zamknięcia systemu
Shutdown Zdarzenie jest wywoływane, gdy ma być wyładowany domeny aplikacji, ładowany w kodzie.To zdarzenie jest obsługiwane przez ThisAddIn_Shutdown metoda w pliku wygenerowanego kodu.Ta procedura obsługi zdarzeń jest ostatni kod użytkownika, aby uruchomić, gdy dodatek jest zwalniany.
Zdarzenia zamknięcia w dodatki programu Outlook
Shutdown Zdarzenie jest wywoływane tylko wtedy, gdy użytkownik wyłączy dodatek za pomocą okna dialogowego Dodatki COM w programie Outlook.Nie jest wywoływane, gdy kończy działanie programu Outlook.Jeśli kod, który należy uruchomić, kiedy program Outlook, obsługiwać jedną z następujących zdarzeń:
Quit Przypadku Application obiektu.
[!UWAGA]
Można wymusić programu Outlook, aby podnieść Shutdown zdarzenie, kiedy to przez modyfikację rejestru.Jednak, jeśli administrator przywraca to ustawienie, dowolny kod były dodawane do ThisAddIn_Shutdown metoda nie działa, kiedy program Outlook.Aby uzyskać więcej informacji, zobacz Zmiany zamknięcia dla programu Outlook 2010.
Zobacz też
Zadania
Porady: tworzenie projektów Office w Visual Studio
Inne zasoby
Tworzenie rozwiązań pakietu Office
Programowanie dostosowań na poziome dokumentu