Exemplarische Vorgehensweise: Erstellen des ersten Add-Ins auf Anwendungsebene für Outlook

Artikel
02/26/2013

In dieser exemplarischen Vorgehensweise wird erläutert, wie Sie ein Add-In auf Anwendungsebene für Microsoft Office Outlook erstellen.Die Features, die Sie in dieser Art von Projektmappe erstellen, sind für die Anwendung selbst verfügbar, unabhängig davon, welches Outlook-Element geöffnet ist.Weitere Informationen finden Sie unter Übersicht über die Entwicklung von Office-Projektmappen.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Anwendungsebene für Outlook 2013 und Outlook 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

Erstellen eines Add-In-Projekts für Outlook.
Schreiben von Code, der das Outlook-Objektmodel verwendet, um dem Betreff und Textkörper einer neuen E-Mail Text hinzuzufügen.
Erstellen und Ausführen des Projekts zum Testen
Bereinigen des abgeschlossenen Projekts, damit das Add-In nicht mehr automatisch auf dem Entwicklungscomputer ausgeführt wird

Hinweis
Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

Eine Version von Visual Studio 2012, die die Microsoft Office-Entwicklungstools einschließt. Weitere Informationen finden Sie unter [Konfigurieren eines Computers zum Entwickeln von Office-Lösungen](bb398242\(v=vs.110\).md).

Outlook 2013 oder Outlook 2010.

Erstellen des Projekts

So erstellen Sie ein neues Outlook-Projekt in Visual Studio

Starten Sie Visual Studio.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Erweitern Sie im Vorlagenbereich den Visual C# oder Visual Basic, und erweitern Sie dann Office/SharePoint.
unter dem erweiterten Knoten Office/SharePoint wählen Sie den Knoten Office-Add-Ins aus.
Wählen Sie in der Liste der Projektvorlagen Outlook 2010-Add-In oder Outlook 2013-Add-In aus.
Geben Sie im Feld Name die Zeichenfolge FirstOutlookAddIn ein.
Klicken Sie auf OK.

Visual Studio erstellt das Projekt FirstOutlookAddIn und öffnet die ThisAddIn-Codedatei im Editor.

Schreiben von Code zum Einfügen von Text in jeder neuen E-Mail

Fügen Sie anschließend der ThisAddIn-Codedatei Code hinzu.Der neue Code verwendet das Outlook-Objektmodell, um Text zu jeder neuen E-Mail hinzuzufügen.Standardmäßig enthält die ThisAddIn-Codedatei den folgenden generierten Code:

Eine partielle Definition der ThisAddIn-Klasse.Diese Klasse liefert einen Einstiegspunkt für den Code und ermöglicht den Zugriff auf das Outlook-Objektmodell.Weitere Informationen finden Sie unter Programmieren von Add-Ins auf Anwendungsebene.Der Rest der ThisAddIn-Klasse ist in einer ausgeblendeten Codedatei definiert, die Sie nicht ändern sollten.
Der ThisAddIn_Startup-Ereignishandler und der ThisAddIn_Shutdown-Ereignishandler.Diese Ereignishandler werden aufgerufen, wenn Outlook das Add-In lädt und entfernt.Verwenden Sie diese Ereignishandler, um das Add-In zu initialisieren, wenn es geladen wird, und um beim Entladen die Ressourcen zu bereinigen, die vom Add-In verwendet werden.Weitere Informationen finden Sie unter Ereignisse in Office-Projekten.

So fügen Sie dem Betreff und Textkörper jeder neuen E-Mail Text hinzu

Deklarieren Sie in der ThisAddIn-Codedatei in der ThisAddIn-Klasse ein Feld mit dem Namen inspectors.Das inspectors-Feld behält einen Verweis auf die Auflistung von Inspektor-Fenstern in der aktuellen Outlook-Instanz bei.Dieser Verweis verhindert, dass der Garbage Collector den Speicher freigibt, der den Ereignishandler für das NewInspector-Ereignis enthält.
```
Private WithEvents inspectors As Outlook.Inspectors
```
```
Outlook.Inspectors inspectors;
```

Ersetzen Sie die ThisAddIn_Startup-Methode durch folgenden Code:Dieser Code fügt einen Ereignishandler an das NewInspector-Ereignis an.

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);
}

Fügen Sie in der ThisAddIn-Codedatei der ThisAddIn-Klasse folgenden Code hinzu.Dieser Code definiert einen Ereignishandler für das NewInspector-Ereignis.

Wenn der Benutzer eine neue E-Mail erstellt, fügt dieser Ereignishandler der Betreffzeile und dem Textkörper der E-Mail Text hinzu.

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";
        }

    }
}

Die vorangegangenen Codebeispiele verwenden zum Ändern jeder neuen E-Mail die folgenden Objekte:

Das Application-Feld der ThisAddIn-Klasse.Das Application-Feld gibt ein Application-Objekt zurück, das die aktuelle Instanz von Outlook darstellt.
Der Inspector-Parameter des Ereignishandlers für das NewInspector-Ereignis.Der Inspector-Parameter ist ein Inspector-Objekt, das das Inspector-Fenster der neuen E-Mail darstellt.Weitere Informationen finden Sie unter Outlook-Projektmappen.

Testen des Projekts

Vergewissern Sie sich, dass beim Erstellen und Ausführen des Projekts der Text in der Betreffzeile und im Textkörper der neuen E-Mail angezeigt wird.

So testen Sie das Projekt

Drücken Sie F5, um das Projekt zu erstellen und auszuführen.

Beim Erstellen des Projekts wird der Code in eine Assembly kompiliert, die in den Buildausgabeordner für das Projekt aufgenommen wird.Visual Studio erstellt auch einen Satz von Registrierungseinträgen, die es Outlook ermöglichen, das Add-In aufzufinden und zu laden, und konfiguriert die Sicherheitseinstellungen auf dem Entwicklungscomputer, damit das Add-In ausgeführt werden kann.Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen des ersten Add-Ins auf Anwendungsebene für Outlook.
Erstellen Sie in Outlook eine neue E-Mail.
Stellen Sie sicher, dass der folgende Text sowohl der Betreffzeile als auch dem Textkörper der E-Mail hinzugefügt wird.

This text was added by using code.
Schließen Sie Outlook.

Bereinigen des Projekts

Wenn Sie die Entwicklung eines Projekts abgeschlossen haben, entfernen Sie die Add-In-Assembly, die Registrierungseinträge und die Sicherheitseinstellungen vom Entwicklungscomputer.Andernfalls wird das Add-In jedes Mal ausgeführt, wenn Sie Outlook auf dem Entwicklungscomputer öffnen.

So bereinigen Sie das Projekt

Klicken Sie in Visual Studio im Menü Erstellen auf Projektmappe bereinigen.

Nächste Schritte

Nachdem Sie nun ein grundlegendes Add-In auf Anwendungsebene für Outlook erstellt haben, können Sie mehr über die Entwicklung von Add-Ins in den folgenden Kapiteln erfahren:

Allgemeine Programmierungsaufgaben, die Sie mit Add-Ins für Outlook bewältigen können.Weitere Informationen finden Sie unter Programmieren von Add-Ins auf Anwendungsebene.
Verwenden des Outlook-Objektmodells.Weitere Informationen finden Sie unter Outlook-Projektmappen.
Anpassen der Benutzeroberfläche von Outlook, beispielsweise durch Hinzufügen einer benutzerdefinierten Registerkarte zum Menüband oder durch Erstellen eines eigenen benutzerdefinierten Aufgabenbereichs.Weitere Informationen finden Sie unter Anpassung der Office-Benutzeroberfläche.
Erstellen und Debuggen von Add-Ins auf Anwendungsebene für Outlook.Weitere Informationen finden Sie unter Aktualisieren von Office-Projektmappen.
Bereitstellen von Add-Ins auf Anwendungsebene für Outlook.Weitere Informationen finden Sie unter Bereitstellen einer Office-Projektmappe.