Übersicht über das Outlook-Objektmodell

  • Artikel

Zum Entwickeln von VSTO-Add-Ins für Microsoft Office Outlook können Sie mit den Objekten interagieren, die vom Outlook-Objektmodell bereitgestellt werden. Das Outlook-Objektmodell stellt Klassen und Schnittstellen bereit, die Elemente der Benutzeroberfläche darstellen. Das Application -Objekt stellt beispielsweise die gesamte Anwendung, das Folder -Objekt einen Ordner mit E-Mails oder anderen Elementen und das MailItem -Objekt eine E-Mail dar.

Dieses Thema enthält eine kurze Übersicht über einige der Hauptobjekte im Outlook-Objektmodell. Ressourcen, in denen Sie mehr über das gesamte Outlook-Objektmodell erfahren können, finden Sie in der Outlook-Objektmodelldokumentation.

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.

Zugreifen auf Objekte in einem Outlook-Projekt

Outlook stellt zahlreiche Objekte bereit, mit denen Sie interagieren können. Damit Sie das Objektmodell effizient verwenden können, sollten Ihnen die folgenden Objekte der obersten Ebene vertraut sein:

Anwendungsobjekt

Das Application -Objekt stellt die Outlook-Anwendung dar und ist im Outlook-Objektmodell das Objekt der obersten Ebene. Zu den wichtigsten Membern dieses Objekts gehören:

  • Die CreateItem -Methode, die Sie zum Erstellen eines neuen Elements wie einer E-Mail, einer Aufgabe oder eines Termins verwenden können.

  • Die Explorers -Eigenschaft, die Sie für den Zugriff auf die Fenster verwenden können, in denen der Inhalt eines Ordners in der Outlook-Benutzeroberfläche (UI) angezeigt wird.

  • Die Inspectors -Eigenschaft, die Sie für den Zugriff auf die Fenster verwenden können, in denen der Inhalt eines einzelnen Elements wie einer E-Mail oder einer Besprechungsanfrage angezeigt wird.

    Verwenden Sie zum Abrufen einer Instanz des Application Objekts das Anwendungsfeld der ThisAddIn Klasse in Ihrem Projekt. Weitere Informationen finden Sie unter Programm-VSTO-Add-Ins.

Hinweis

Um Sicherheitswarnungen zu vermeiden, wenn Sie Eigenschaften und Methoden verwenden, die vom Outlook-Objektmodellschutz blockiert werden, rufen Sie Outlook-Objekte aus dem Anwendungsfeld der ThisAddIn Klasse ab. Weitere Informationen finden Sie unter Spezifische Sicherheitsüberlegungen für Office-Lösungen.

Explorer-Objekt

Das Explorer -Objekt stellt ein Fenster dar, in dem der Inhalt eines Ordners angezeigt wird, der Elemente wie E-Mails, Aufgaben oder Termine enthält. Das Explorer -Objekt enthält Methoden und Eigenschaften, die Sie zum Ändern des Fensters verwenden können, sowie Ereignisse, die bei einer Änderung des Fensters ausgelöst werden.

Führen Sie einen der folgenden Schritte aus, um ein Explorer -Objekt abzurufen:

Inspector-Objekt

Das Inspector -Objekt stellt ein Fenster dar, in dem ein einzelnes Element wie eine E-Mail, eine Aufgabe oder ein Termin angezeigt wird. Das Inspector -Objekt enthält Methoden und Eigenschaften, die Sie zum Ändern des Fensters verwenden können, sowie Ereignisse, die bei einer Änderung des Fensters ausgelöst werden.

Führen Sie einen der folgenden Schritte aus, um ein Inspector -Objekt abzurufen:

Folder-Objekt

Das Folder -Objekt stellt einen Ordner dar, der E-Mails, Kontakte, Aufgaben und andere Elemente enthält. Outlook stellt 16 Folder -Standardobjekte bereit.

Die Folder -Standardobjekte werden durch die Werte der OlDefaultFolders -Enumeration definiert. Ein auf ein Objekt angewendeter

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox entspricht dem Ordner "Posteingang " in Outlook.

Ein Beispiel, das zeigt, wie Sie auf eine Standardeinstellung Folder zugreifen und eine neue Foldererstellen, finden Sie unter How to: Programmatically create custom folder items.

MailItem-Objekt

Das MailItem -Objekt stellt eine E-Mail dar. MailItem -Objekte befinden sich normalerweise in Ordnern wie Posteingang, Gesendete Elementeund Postausgang. MailItem macht Eigenschaften und Methoden verfügbar, die zum Erstellen und Senden von E-Mails verwendet werden können.

Ein Beispiel zum Erstellen einer E-Mail-Nachricht finden Sie unter Vorgehensweise: Programmgesteuertes Erstellen eines E-Mail-Elements.

AppointmentItem-Objekt

Das AppointmentItem -Objekt stellt eine Besprechung, einen einmaligen Termin, eine Terminserie oder eine Besprechungsserie im Ordner Kalender dar. Das AppointmentItem -Objekt enthält Methoden zum Ausführen von Aktionen, z. B. Beantworten oder Weiterleiten von Besprechungsanfragen, sowie Eigenschaften, mit denen Besprechungsdetails wie Ort und Zeit angegeben werden.

Ein Beispiel zum Erstellen eines Termins finden Sie unter How to: Programmatically create a meeting request.

TaskItem-Objekt

Das TaskItem -Objekt stellt eine Aufgabe dar, die innerhalb eines bestimmten Zeitrahmens ausgeführt werden muss. TaskItem -Objekte befinden sich im Ordner Aufgaben .

Verwenden Sie zum Erstellen einer Aufgabe die CreateItem -Methode des Application -Objekts, und übergeben Sie für den Parameter den Wert olTaskItem .

ContactItem-Objekt

Das ContactItem-Objekt stellt einen Kontakt im Ordner Kontakte dar. ContactItem -Objekte enthalten eine Reihe von Kontaktinformationen für die Personen, die sie darstellen, z. B. Anschriften, E-Mail-Adressen und Telefonnummern.

Ein Beispiel zum Erstellen eines neuen Kontakts finden Sie unter Vorgehensweise: Programmgesteuertes Hinzufügen eines Eintrags zu Outlook-Kontakten. Ein Beispiel, das zeigt, wie Sie nach einem vorhandenen Kontakt suchen, finden Sie unter How to: Programmatically search for a specific contact.

Verwenden der Outlook-Objektmodelldokumentation

Vollständige Informationen zum Outlook-Objektmodell finden Sie in der Referenz zur primären Interopassembly (PIA) für Outlook und der VBA-Objektmodellreferenz.

Referenz zur primären Interopassembly

In der Referenz für die Outlook-PIA sind die Typen in den primären Interopassemblys für Outlook 2010 dokumentiert. Weitere Informationen finden Sie in der Referenz zur primären Interopassembly von Outlook 2010.

Diese Dokumentation enthält neben Informationen zu allen Typen in den PIAs zusätzliche Informationen zur Struktur der PIAs und Codebeispiele für allgemeine Automatisierungsaufgaben in Outlook.

VBA-Objektmodellreferenz

Die VBA-Objektmodellreferenz dokumentiert das Outlook-Objektmodell, das für VBA (Visual Basic for Applications)-Code verfügbar gemacht wird. Weitere Informationen finden Sie in der Outlook 2010-Objektmodellreferenz.

Alle Objekte und Member in der VBA-Objektmodellreferenz entsprechen Typen und Membern in der Outlook-PIA. Beispielsweise entspricht das Inspector-Objekt im VBA-Objektmodellverweis dem Inspector Objekt in der Outlook-PIA. Obwohl die VBA-Objektmodellreferenz Codebeispiele für die meisten Eigenschaften, Methoden und Ereignisse enthält, müssen Sie den VBA-Code in dieser Referenz in Visual Basic oder Visual C# übersetzen, wenn Sie ihn in einem mit Visual Studio erstellten Outlook-VSTO-Add-In-Projekt verwenden möchten.

Titel Beschreibung
Arbeiten mit Kontaktelementen Enthält Themen, die das Ausführen von Aufgaben mit Kontakten veranschaulichen.
Arbeiten mit E-Mail-Elementen Enthält Themen, die das Ausführen von Aufgaben mit Mailelementen veranschaulichen.
Arbeiten mit Ordnern Enthält Themen, die das Ausführen von Aufgaben mit Ordnern veranschaulichen.
Arbeiten mit Kalenderelementen Enthält Themen, die das Ausführen von Aufgaben mit Kalenderelementen veranschaulichen.
Vorgehensweise: Programmgesteuertes Bestimmen des aktuellen Outlook-Elements Zeigt, wie der Name des aktuellen Ordners und Informationen zum ausgewählten Element angezeigt werden.