Udostępnij za pośrednictwem

Instruktaż: Tworzenie na pierwszym poziomie aplikacji Add-in for Outlook

  • Artykuł

W tym instruktażu przedstawiono sposób stworzyć poziom aplikacji dodatek Microsoft Office Outlook.Funkcje, które można tworzyć w tego rodzaju rozwiązanie są dostępne dla samej aplikacji, niezależnie od tego, który element programu Outlook jest otwarty.Aby uzyskać więcej informacji, zobacz Przegląd rozwoju rozwiązań pakietu Office.

Dotyczy: Informacje przedstawione w tym temacie dotyczą projektów na poziomie aplikacji dla programów Outlook 2013 i Outlook 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacji pakietu Office i typ projektu.

W tym instruktażu przedstawiono następujące zadania:

  • Tworzenie projektu w dodatek programu Outlook dla programu Outlook.

  • Pisanie kodu, który używa modelu obiektów programu Outlook, aby dodać tekst do temat i treść wiadomości programu Poczta.

  • Tworzenie i uruchamianie projektu, aby go przetestować.

  • Oczyszczanie zakończonych projektów tak, że dodatek nie działa automatycznie na komputerze dewelopera.

[!UWAGA]

Na danym komputerze mogą być używane inne nazwy lub lokalizacje pewnych elementów interfejsu użytkownika programu Visual Studio, które są używane w poniższych instrukcjach. Używana wersja programu Visual Studio oraz jej ustawienia określają te elementy. Aby uzyskać więcej informacji, zobacz Visual Studio, ustawienia.

Wymagania wstępne

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

-

Wersja Visual Studio 2012 zawierająca narzędzia dla deweloperów pakietu Microsoft Office. Aby uzyskać więcej informacji, zobacz [Konfigurowanie komputera do opracowywania rozwiązań pakietu Office](bb398242\(v=vs.110\).md).
  • Outlook 2013or Outlook 2010.

Tworzenie projektu

Aby utworzyć nowy projekt programu Outlook 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, Outlook 2010 Add-in lub Outlook 2013 Add-in.

  6. W Nazwa wpisz FirstOutlookAddIn.

  7. Kliknij przycisk OK.

    Visual StudioTworzy FirstOutlookAddIn projekt i otwiera ThisAddIn pliku kodu w edytorze.

Pisanie kodu, który dodaje tekst, aby każda nowa wiadomość pocztowa

Następnie należy dodać kod do pliku kod ThisAddIn.Nowy kod używa modelu obiektów programu Outlook, aby dodać tekst do każdej nowej wiadomości poczty.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 obiektów programu Outlook.Aby uzyskać więcej informacji, zobacz Programowanie aplikacji poziom dodatki.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 Outlook ł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ć tekst do temat i treść każda nowa wiadomość pocztowa

  1. W pliku ThisAddIn kod, należy zadeklarować pole o nazwie inspectors w ThisAddIn klasy.inspectors Pole prowadzi odwołanie do kolekcji windows inspektora w bieżącym wystąpieniu programu Outlook.To odwołanie uniemożliwia garbage collector zwalniania pamięci, która zawiera program obsługi zdarzeń dla NewInspector zdarzenie.

    Private WithEvents inspectors As Outlook.Inspectors

    Outlook.Inspectors inspectors;

  2. Zamień ThisAddIn_Startup metoda następujący kod.Ten kod przywiązuje Obsługa zdarzeń do NewInspector zdarzenie.

    Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    inspectors = Me.Application.Inspectors
End Sub

    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 ThisAddIn kodu, Dodaj następujący kod do ThisAddIn klasy.Ten kod definiuje obsługi zdarzenia NewInspector zdarzenie.

    Gdy użytkownik tworzy nową wiadomość e-mail, ten program dodaje tekst wiersza temat i treść wiadomości.

    Private Sub inspectors_NewInspector(ByVal Inspector As Microsoft.Office.Interop.Outlook.Inspector) Handles inspectors.NewInspector
    Dim mailItem As Outlook.MailItem = TryCast(Inspector.CurrentItem, Outlook.MailItem)
    If Not (mailItem Is Nothing) Then
        If mailItem.EntryID Is Nothing Then
            mailItem.Subject = "This text was added by using code"
            mailItem.Body = "This text was added by using code"
        End If
    End If
End Sub

    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żda nowa wiadomość pocztowa, poprzednich przykładach kodu używać następujących obiektów:

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

  • Inspector Parametr programu obsługi zdarzeń dla NewInspector zdarzenie.Inspector Parametr jest Inspector obiekt, który reprezentuje okno Inspektora nowych wiadomości.Aby uzyskać więcej informacji, zobacz Rozwiązania programu Outlook.

Testowanie projektu

Gdy skompilować i uruchomić projekt, sprawdź, że tekst pojawia się w temacie i nowe wiadomości poczty.

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ą programu Outlook odkryć i załadować dodatek i konfiguruje ustawienia zabezpieczeń na komputerze deweloperskim, aby włączyć dodatek do uruchomienia.Aby uzyskać więcej informacji, zobacz Instruktaż: Tworzenie na pierwszym poziomie aplikacji Add-in for Outlook.

  2. W programie Outlook należy utworzyć nową wiadomość pocztową.

  3. Sprawdź, że następujący tekst dodaje się wiersz tematu i treści wiadomości.

    Tekst ten został dodany za pomocą kodu.

  4. Zamknij program Outlook.

Czyszczenie projektu

Po zakończeniu opracowanie projektu,-w zestawie, wpisy rejestru i ustawienia zabezpieczeń należy usunąć z komputera rozwoju.W przeciwnym razie zostanie uruchomiony dodatek każdym otwarciu programu Outlook na komputerze deweloperskim.

Aby oczyścić projektu

  • W programie Visual Studio na budować menu, kliknij przycisk Rozwiązanie.

Następne kroki

Teraz, że utworzono podstawowy poziom aplikacji dodatek dla programu Outlook, można dowiedzieć się więcej o opracowanie dodatki z tych tematów:

Zobacz też

Inne zasoby

Programowanie aplikacji poziom dodatki

Rozwiązania programu Outlook

Dodatek dostosowywania interfejsu użytkownika pakietu Office

Konstruowanie rozwiązań pakietu Office

Wdrażanie rozwiązania do pakietu Office

Omówienie szablonów programu Office Project