Übersicht über das Outlook-Objektmodell

Bei der Entwicklung von Add-Ins für Microsoft Office Outlook können Sie mit den vom Outlook-Objektmodell bereitgestellten Objekten interagieren.Das Outlook-Objektmodell stellt Klassen und Schnittstellen bereit, die Benutzeroberflächenelemente darstellen.So stellt zum Beispiel das Application-Objekt die gesamte Anwendung dar, während das MAPIFolder-Objekt einen Ordner mit E-Mail-Nachrichten oder anderen Elementen und das MailItem-Objekt eine einzelne E-Mail-Nachricht darstellt.

Dieses Thema enthält eine kurze Übersicht über einige der wichtigsten Objekte im Outlook-Objektmodell.Ressourcen, in denen Sie mehr über das gesamte Outlook-Objektmodell erfahren, finden Sie unter Verwenden der Dokumentation zum Outlook-Objektmodell.

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.

Eine entsprechende Videodemo finden Sie im Thema zur Verwendung von Outlook zum Erstellen eines benutzerdefinierten Vorgangsberichts (möglicherweise in englischer Sprache).

Zugreifen auf Objekte in einem Outlook-Projekt

Outlook stellt viele Objekte bereit, mit denen Sie interagieren können.Um das Objektmodell wirksam verwenden zu können, sollten Sie mit den folgenden Objekten der obersten Ebene vertraut sein:

• Application

• Explorer

• Inspector

• MAPIFolder

• MailItem

• AppointmentItem

• TaskItem

• ContactItem

Application-Objekt

Das Application-Objekt stellt die Outlook-Anwendung dar und befindet sich damit auf der obersten Ebene des Outlook-Objektmodells.Zu den wichtigsten Membern dieses Objekts gehören:

• Die CreateItem-Methode, die verwendet wird, um ein neues Element zu erstellen, z. B. eine E-Mail-Nachricht, eine Aufgabe oder einen Termin.

• Die Explorers-Eigenschaft, mit der auf die Fenster zugegriffen wird, in denen in der Outlook-Benutzeroberfläche der Inhalt von Ordnern angezeigt wird.

• Die Inspectors-Eigenschaft, mit der auf die Fenster zugegriffen wird, in denen der Inhalt eines einzelnen Elements (z. B. einer E-Mail-Nachricht oder einer Besprechungsanfrage) angezeigt wird.

Verwenden Sie zum Abrufen einer Instanz des Application-Objekts das Application-Feld der ThisAddIn-Klasse im Projekt.Weitere Informationen finden Sie unter Programmieren von Add-Ins auf Anwendungsebene.

Hinweis
Um zu verhindern, dass bei der Verwendung von Eigenschaften und Methoden, die vom Outlook-Objektmodellschutz blockiert werden, Sicherheitswarnungen angezeigt werden, rufen Sie die Outlook-Objekte über das Application-Feld der ThisAddIn-Klasse ab.Weitere Informationen finden Sie unter Überlegungen zur Sicherheit von Office-Projektmappen.

Explorer-Objekt

Das Explorer-Objekt stellt ein Fenster dar, in dem der Inhalt eines Ordner angezeigt wird, der Elemente wie E-Mail-Nachrichten, Aufgaben oder Termine enthält.Das Explorer-Objekt enthält Methoden und Eigenschaften zum Modifizieren des Fensters sowie Ereignisse, die bei einer Änderung des Fensters ausgelöst werden.

Zum Abrufen eines Explorer-Objekts haben Sie folgende Möglichkeiten:

• Verwenden Sie die Explorers-Eigenschaft des Application-Objekts, um auf alle Explorer-Objekte in Outlook zuzugreifen.

• Verwenden Sie die ActiveExplorer-Methode des Application-Objekts, um das Explorer-Objekt abzurufen, das gerade den Fokus besitzt.

• Verwenden Sie die GetExplorer-Methode des MAPIFolder-Objekts, um das Explorer-Objekt für den aktuellen Ordner abzurufen.

Inspector-Objekt

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

Zum Abrufen eines Inspector-Objekts haben Sie folgende Möglichkeiten:

• Verwenden Sie die Inspectors-Eigenschaft des Application-Objekts, um auf alle Inspector-Objekte in Outlook zuzugreifen.

• Verwenden Sie die ActiveInspector-Methode des Application-Objekts, um das Inspector-Objekt abzurufen, das gerade den Fokus besitzt.

• Verwenden Sie die GetInspector-Methode eines bestimmten Elements, z. B. MailItem oder AppointmentItem, um den zugeordneten Inspektor abzurufen.

MAPIFolder-Objekt

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

Die MAPIFolder-Standardobjekte werden durch die Werte der OlDefaultFolders-Enumeration definiert.Beispiel:

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

Ein Beispiel, das zeigt, wie Sie auf einen Standard-MAPIFolder zugreifen und einen neuen MAPIFolder erstellen, finden Sie unter Gewusst wie: Programmgesteuertes Erstellen von benutzerdefinierten Ordnerelementen.

MailItem-Objekt

Das MailItem-Objekt stellt eine E-Mail dar.MailItem-Objekte befinden sich normalerweise in Ordnern, z. B. Posteingang, Gesendete Elemente und Postausgang.MailItem macht Eigenschaften und Methoden verfügbar, die verwendet werden können, um E-Mails zu erstellen und zu senden.

Ein Beispiel für das Erstellen einer E-Mail-Nachricht finden Sie unter Gewusst wie: Programmgesteuertes Erstellen von E-Mail-Elementen.

AppointmentItem-Objekt

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

Ein Beispiel für das Erstellen eines Termins finden Sie unter Gewusst wie: Programmgesteuertes Erstellen einer Besprechungsanfrage.

TaskItem-Objekt

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

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

ContactItem-Objekt

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

Ein Beispiel für das Erstellen eines neuen Kontakts finden Sie unter Gewusst wie: Programmgesteuertes Hinzufügen eines Eintrags zu Outlook-Kontakten.Ein Beispiel, das zeigt, wie Sie nach einem vorhandenen Kontakt suchen, finden Sie unter Gewusst wie: Programmgesteuertes Suchen eines bestimmten Kontakts.

Verwenden der Dokumentation für das Outlook-Objektmodell

Ausführliche Informationen zum Outlook-Objektmodell finden Sie in der Referenz für die primäre Interopassembly (PIA) für Outlook und der VBA-Objektmodellreferenz.

Referenz für die primäre Interopassembly

In der Outlook-PIA-Referenz sind die Typen in den primären Interopassemblys für Outlook 2010.Weitere Informationen finden Sie unter Verweis Outlook 2010 primärer Interop-Assemblys.

Neben Informationen zu allen Typen in den PIAs enthält diese Dokumentation zusätzliche Informationen zur Struktur der PIAs und Codebeispiele für häufige Outlook-Automatisierungsaufgaben.

VBA-Objektmodellreferenz

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

Alle Objekte und Member in der VBA-Objektmodellreferenz entsprechen Typen und Membern in der Outlook-PIA.Das Inspector-Objekt in der VBA-Objektmodellreferenz entspricht z. B. dem Microsoft.Office.Interop.Outlook.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-Add-In-Projekt verwenden möchten.

Verwandte Themen

Titel	Description
Arbeiten mit Kontaktelementen	Hier finden Sie Themen, in denen die Ausführung von Aufgaben im Zusammenhang mit Kontakten beschrieben wird.
Arbeiten mit E-Mail-Elementen	Hier finden Sie Themen, in denen die Ausführung von Aufgaben im Zusammenhang mit E-Mail-Elementen beschrieben wird.
Arbeiten mit Ordnern	Hier finden Sie Themen, in denen die Ausführung von Aufgaben im Zusammenhang mit Ordnern beschrieben wird.
Arbeiten mit Kalenderelementen	Hier finden Sie Themen, in denen die Ausführung von Aufgaben im Zusammenhang mit Kalenderelementen beschrieben wird.
Gewusst wie: Programmgesteuertes Bestimmen des aktuellen Outlook-Elements	Hier wird gezeigt, wie der Name des aktuellen Ordners und einige Informationen zum ausgewählten Element angezeigt werden.