Udostępnij za pośrednictwem

Przewodnik: tworzenie pierwszego dodatku VSTO dla programu Outlook

  • Artykuł

W tym przewodniku pokazano, jak utworzyć dodatek VSTO dla programu Microsoft Office Outlook. Funkcje tworzone w tym rodzaju rozwiązania są dostępne dla samej aplikacji, niezależnie od tego, który element programu Outlook jest otwarty. Aby uzyskać więcej informacji, zobacz Omówienie programowania rozwiązań pakietu Office (VSTO).

Dotyczy: informacje w tym temacie dotyczą projektów dodatków VSTO dla programu Outlook. 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 programu Outlook VSTO dla programu Outlook.

  • Pisanie kodu korzystającego z modelu obiektów programu Outlook w celu dodania tekstu do tematu i treści nowej wiadomości e-mail.

  • 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 programu Outlook 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 projekt dodatku programu Outlook VSTO.

  6. W polu Nazwa wpisz FirstOutlookAddIn.

  7. Kliknij przycisk OK.

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

Pisanie kodu, który dodaje tekst do każdej nowej wiadomości e-mail

Następnie dodaj kod do pliku kodu ThisAddIn. Nowy kod używa modelu obiektów programu Outlook do dodawania tekstu do każdej nowej wiadomości e-mail. 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 Outlook. 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 Outlook ładuje i zwalnia dodatek VSTO. Użyj tych procedur obsługi zdarzeń, aby zainicjować dodatek VSTO podczas ładowania i wyczyścić zasoby używane przez dodatek VSTO podczas jego zwolnienia. Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

Aby dodać tekst do tematu i treści każdej nowej wiadomości e-mail

  1. W pliku kodu ThisAddIn zadeklaruj ThisAddIn pole o nazwie inspectors w klasie . Pole inspectors utrzymuje odwołanie do kolekcji okien Inspector w bieżącym wystąpieniu programu Outlook. To odwołanie uniemożliwia modułowi odśmiecania pamięci, który zawiera program obsługi zdarzeń dla NewInspector zdarzenia.

    Outlook.Inspectors inspectors;

  2. Zastąp metodę ThisAddIn_Startup następującym kodem. Ten kod dołącza procedurę obsługi zdarzeń do NewInspector zdarzenia.

    private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    inspectors = this.Application.Inspectors;
    inspectors.NewInspector +=
    new Microsoft.Office.Interop.Outlook.InspectorsEvents_NewInspectorEventHandler(Inspectors_NewInspector);
}

  3. W pliku kodu ThisAddIn dodaj następujący kod do ThisAddIn klasy . Ten kod definiuje procedurę obsługi zdarzeń dla NewInspector zdarzenia.

    Gdy użytkownik utworzy nową wiadomość e-mail, ta procedura obsługi zdarzeń dodaje tekst do wiersza tematu i treści wiadomości.

    void Inspectors_NewInspector(Microsoft.Office.Interop.Outlook.Inspector Inspector)
{
    Outlook.MailItem mailItem = Inspector.CurrentItem as Outlook.MailItem;
    if (mailItem != null)
    {
        if (mailItem.EntryID == null)
        {
            mailItem.Subject = "This text was added by using code";
            mailItem.Body = "This text was added by using code";
        }

    }
}

    Aby zmodyfikować każdą nową wiadomość e-mail, poprzednie przykłady kodu używają następujących obiektów:

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

  • Inspector Parametr programu obsługi zdarzeń dla NewInspector zdarzenia. Parametr Inspector jest obiektem reprezentującym Inspector okno Inspector (Inspektor) nowej wiadomości e-mail. Aby uzyskać więcej informacji, zobacz Rozwiązania programu Outlook.

Testowanie projektu

Podczas kompilowania i uruchamiania projektu sprawdź, czy tekst pojawia się w wierszu tematu i treści nowej wiadomości e-mail.

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 Outlook odnajdywanie i ładowanie dodatku VSTO oraz konfigurowanie ustawień zabezpieczeń na komputerze dewelopera w celu włączenia uruchamiania dodatku VSTO. Aby uzyskać więcej informacji, zobacz Omówienie procesu kompilacji rozwiązania pakietu Office.

  2. W programie Outlook utwórz nową wiadomość e-mail.

  3. Sprawdź, czy następujący tekst został dodany zarówno do wiersza tematu, jak i treści wiadomości.

    Ten tekst został dodany przy użyciu kodu.

  4. Zamknij program Outlook.

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 uruchamiany za każdym razem, gdy otworzysz program Outlook na komputerze dewelopera.

Aby wyczyścić projekt

  1. W programie Visual Studio w menu Kompilacja kliknij pozycję Wyczyść rozwiązanie.

Następne kroki

Po utworzeniu podstawowego dodatku VSTO dla programu Outlook możesz dowiedzieć się więcej na temat tworzenia dodatków VSTO z następujących tematów:

  • Ogólne zadania programistyczne, które można wykonywać przy użyciu dodatków VSTO dla programu Outlook. Aby uzyskać więcej informacji, zobacz Program VSTO Add-ins (Dodatki programu VSTO).

  • Korzystanie z modelu obiektów programu Outlook. Aby uzyskać więcej informacji, zobacz Rozwiązania programu Outlook.

  • Dostosowywanie interfejsu użytkownika programu Outlook, na przykład przez dodanie karty niestandardowej do wstążki lub utworzenie własnego niestandardowego okienka zadań. Aby uzyskać więcej informacji, zobacz Dostosowywanie interfejsu użytkownika pakietu Office.

  • Kompilowanie i debugowanie dodatków VSTO dla programu Outlook. Aby uzyskać więcej informacji, zobacz Tworzenie rozwiązań pakietu Office.

  • Wdrażanie dodatków VSTO dla programu Outlook. Aby uzyskać więcej informacji, zobacz Wdrażanie rozwiązania pakietu Office.

Powiązana zawartość