Exemplarische Vorgehensweise: Erstellen Ihres ersten VSTO-Add-Ins für Outlook

  • Artikel

Diese exemplarische Vorgehensweise veranschaulicht die Erstellung eines VSTO-Add-Ins für Microsoft Office Outlook. Die in dieser Art von Projektmappe erstellten Features sind für die Anwendung selbst verfügbar. Dabei spielt es keine Rolle, welches Outlook-Element geöffnet sind. Weitere Informationen finden Sie unter Übersicht über die Entwicklung von Office-Lösungen (VSTO).

Gilt für: Die Informationen in diesem Thema gelten für VSTO-Add-In-Projekte für Outlook. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

Hinweis

Möchten Sie Lösungen entwickeln, die die Office-Erfahrung auf mehreren Plattformen erweitern? Schauen Sie sich das neue Office-Add-Ins-Modell an. Office-Add-Ins haben im Vergleich zu VSTO-Add-Ins und -Lösungen einen geringen Platzbedarf, und Sie können diese mithilfe nahezu jeder Webprogrammiertechnologie erstellen, z. B. HTML5, JavaScript, CSS3 und XML.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

  • Erstellen eines VSTO-Add-In-Projekts für Outlook

  • Schreiben von Code, der das Outlook-Objektmodell verwendet, um der Betreffzeile und dem Textkörper einer neuen E-Mail Text hinzuzufügen

  • Erstellen Sie das Projekt, und führen Sie es aus, um es zu testen.

  • Bereinigen des abgeschlossenen Projekts, damit das VSTO-Add-In nicht mehr automatisch auf Ihrem Entwicklungscomputer ausgeführt wird.

    Hinweis

    Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in den folgenden Anweisungen aufgeführten. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Personalisieren der IDE.

Voraussetzungen

Zum Abschließen dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

Erstellen des Projekts

So erstellen Sie ein neues Outlook-Projekt in Visual Studio

  1. Starten Sie Visual Studio.

  2. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

  3. Erweitern Sie im Vorlagenbereich Visual C# oder Visual Basicund dann Office/SharePoint.

  4. Wählen Sie unter dem erweiterten Knoten Office/SharePoint den Knoten Office-Add-Ins aus.

  5. Wählen Sie in der Liste der Projektvorlagen ein Outlook-VSTO-Add-In-Projekt aus.

  6. Geben Sie im Feld Name den Text FirstOutlookAddInein.

  7. Klicken Sie auf OK.

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

Schreiben von Code, der jeder neuen E-Mail-Nachricht Text hinzufügt

Als Nächstes fügen Sie der Codedatei „ThisAddIn“ Code hinzu. Der neue Code verwendet das Outlook-Objektmodell, um jeder neuen E-Mail Text hinzuzufügen. Standardmäßig enthält die Codedatei „ThisAddIn“ den folgenden generierten Code:

  • Eine Teildefinition der ThisAddIn -Klasse. Diese Klasse stellt einen Einstiegspunkt für Ihren Code bereit und ermöglicht den Zugriff auf das Outlook-Objektmodell. Weitere Informationen finden Sie unter Programm-VSTO-Add-Ins. Der Erneute Standard der der ThisAddIn Klasse wird in einer ausgeblendeten Codedatei definiert, die Sie nicht ändern sollten.

  • Die Ereignishandler ThisAddIn_Startup und ThisAddIn_Shutdown . Diese Ereignishandler werden aufgerufen, wenn Ihr VSTO-Add-In von Outlook geladen oder entladen wird. Verwenden Sie diese Ereignishandler zum Initialisieren des VSTO-Add-Ins, wenn es geladen wird, und zum Bereinigen der vom VSTO-Add-In verwendeten Ressourcen, wenn es entladen wird. Weitere Informationen finden Sie unter "Ereignisse in Office-Projekten".

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

  1. Deklarieren Sie in der ThisAddIn-Codedatei ein Feld namens inspectors in der ThisAddIn -Klasse. Das inspectors -Feld behält einen Verweis auf die Auflistung von Inspektor-Fenstern in der aktuellen Outlook-Instanz. Dieser Verweis verhindert, dass der Garbage Collector den Speicher freigibt, der den Ereignishandler für das NewInspector -Ereignis enthält.

    Outlook.Inspectors inspectors;

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

    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. Fügen Sie in der Codedatei „ThisAddIn“ der ThisAddIn -Klasse den 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 Nachricht Text hinzu.

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

    }
}

    Zum Ändern der einzelnen neuen E-Mails werden in den vorherigen Codebeispielen die folgenden Objekte verwendet:

  • Das Feld Application der ThisAddIn -Klasse. Das Application -Feld gibt ein Application -Objekt zurück, das für die aktuelle Instanz von Outlook steht.

  • Der Parameter Inspector des Ereignishandlers für das NewInspector -Ereignis. Der Inspector -Parameter ist ein Inspector -Objekt, das das Inspektorfenster der neuen E-Mail darstellt. Weitere Informationen finden Sie unter Outlook-Lösungen.

Testen des Projekts

Wenn Sie das Projekt erstellen und ausführen, stellen Sie sicher, dass der Text in der Betreffzeile und dem Textkörper der neuen E-Mail angezeigt wird.

So testen Sie das Projekt

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

    Wenn Sie das Projekt erstellen, wird der Code in eine Assembly kompiliert, die im Buildausgabeordner des Projekts enthalten ist. Visual Studio erstellt auch einen Satz von Registrierungseinträgen, mit deren Hilfe Outlook das VSTO-Add-In ermitteln und laden kann. Die Sicherheitseinstellungen auf dem Entwicklungscomputer werden so konfiguriert, dass das VSTO-Add-In ausgeführt werden kann. Weitere Informationen finden Sie unter Übersicht über den Office-Lösungsbuildprozess.

  2. Erstellen Sie in Outlook eine neue E-Mail.

  3. Stellen Sie sicher, dass der folgende Text sowohl der Betreffzeile als auch dem Textkörper der Nachricht hinzugefügt wird.

    Dieser Text wurde per Code hinzugefügt.

  4. Schließen Sie Outlook.

Bereinigen des Projekts

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

So bereinigen Sie das Projekt

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

Nächste Schritte

Nachdem Sie nun ein einfaches VSTO-Add-In für Outlook erstellt haben, erfahren Sie in den folgenden Themen mehr über die Entwicklung von VSTO-Add-Ins:

  • Allgemeine Programmieraufgaben, die Sie ausführen können, indem Sie VSTO-Add-Ins für Outlook verwenden. Weitere Informationen finden Sie unter Programm-VSTO-Add-Ins.

  • Verwenden des Outlook-Objektmodells. Weitere Informationen finden Sie unter Outlook-Lösungen.

  • Anpassen der Outlook-Benutzeroberfläche (UI) beispielsweise durch das Hinzufügen einer benutzerdefinierten Registerkarte zum Menüband oder durch das Erstellen eines eigenen benutzerdefinierten Aufgabenbereichs. Weitere Informationen finden Sie in der Anpassung der Office-Benutzeroberfläche.

  • Erstellen und Debuggen von VSTO-Add-Ins für Outlook. Weitere Informationen finden Sie unter Erstellen von Office-Lösungen.

  • Bereitstellen von VSTO-Add-Ins für Outlook. Weitere Informationen finden Sie unter Bereitstellen einer Office-Lösung.

Zugehöriger Inhalt