Freigeben über

Übersicht über das Outlook-Objektmodell

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 auf der Benutzeroberfläche darstellen. Beispielsweise stellt das Application Objekt die gesamte Anwendung dar, das Folder Objekt stellt einen Ordner dar, der E-Mail-Nachrichten oder andere Elemente enthält, und das MailItem Objekt stellt eine E-Mail-Nachricht 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 Funktionen verfügbar nach Office-Anwendung und Projekttyp.

Zugreifen auf Objekte in einem Outlook-Projekt

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

Anwendungsobjekt

Das Application Objekt stellt die Outlook-Anwendung dar, und es handelt sich um das Objekt der höchsten Ebene im Outlook-Objektmodell. Einige der wichtigsten Elemente dieses Objekts sind:

  • Die CreateItem-Methode , mit der Sie ein neues Element erstellen können, z. B. eine E-Mail-Nachricht, eine Aufgabe oder einen Termin.

  • Die Explorers Eigenschaft, die Sie verwenden können, um auf die Fenster zuzugreifen, die den Inhalt eines Ordners auf der Outlook-Benutzeroberfläche (UI) anzeigen.

  • Die Inspectors Eigenschaft, die Sie verwenden können, um auf die Fenster zuzugreifen, die den Inhalt eines einzelnen Elements anzeigen, z. B. eine E-Mail-Nachricht oder Besprechungsanfrage.

    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-Mail-Nachrichten, Aufgaben oder Termine enthält. Das Explorer Objekt enthält Methoden und Eigenschaften, mit denen Sie das Fenster ändern können, sowie Ereignisse, die ausgelöst werden, wenn sich das Fenster ändert.

Führen Sie zum Abrufen eines Explorer Objekts eine der folgenden Aktionen aus:

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, mit denen Sie das Fenster ändern können, sowie Ereignisse, die ausgelöst werden, wenn sich das Fenster ändert.

Führen Sie zum Abrufen eines Inspector Objekts eine der folgenden Aktionen aus:

Folder-Objekt

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

Die Standardobjekte Folder werden durch die OlDefaultFolders Enumerationswerte definiert. Beispiel:

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox entspricht dem Posteingang-Ordner 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-Nachricht dar. MailItem Objekte befinden sich in der Regel in Ordnern, z. B. " Posteingang", " Gesendete Elemente" und "Postausgang". MailItem macht Eigenschaften und Methoden verfügbar, die zum Erstellen und Senden von E-Mail-Nachrichten 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 oder eine Terminserie oder Besprechung im Kalenderordner dar. Das AppointmentItem Objekt enthält Methoden, die Aktionen ausführen, z. B. das Beantworten oder Weiterleiten von Besprechungsanfragen sowie Eigenschaften, die Besprechungsdetails wie Ort und Uhrzeit angeben.

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 angegebenen Zeitrahmens ausgeführt werden soll. TaskItem Objekte befinden sich im Ordner "Aufgaben ".

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

ContactItem-Objekt

Das ContactItemObjekt stellt einen Kontakt im Ordner Kontakte dar. ContactItem Objekte enthalten eine Vielzahl von Kontaktinformationen für die Personen, die sie darstellen, z. B. Straßenadressen, 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 der primären Interop-Assembly (PIA) von Outlook und der VBA-Objektmodell-Referenz.

Referenz zur primären Interop-Assembly

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

Zusätzlich zur Bereitstellung von Informationen für alle Typen in den PIAs enthält diese Dokumentation auch zusätzliche Informationen zur Struktur der PIAs und Codebeispiele für allgemeine Outlook-Automatisierungsaufgaben.

VBA-Objektmodellreferenz

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

Alle Objekte und Elemente 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 bereitstellt, müssen Sie den VBA-Code in dieser Referenz in Visual Basic oder Visual C# übersetzen, wenn Sie sie in einem Outlook-VSTO-Add-In-Projekt verwenden möchten, das Sie mit Visual Studio erstellen.

Title Description
Arbeiten mit Kontaktelementen Enthält Themen, die zeigen, wie Aufgaben mit Kontakten ausgeführt werden.
Arbeiten mit E-Mail-Elementen Enthält Themen, die zeigen, wie Aufgaben mit E-Mail-Elementen ausgeführt werden.
Arbeiten mit Ordnern Enthält Themen, die zeigen, wie Aufgaben mit Ordnern ausgeführt werden.
Arbeiten mit Kalenderelementen Enthält Themen, die zeigen, wie Aufgaben mit Kalenderelementen ausgeführt werden.
Vorgehensweise: Programmgesteuertes Bestimmen des aktuellen Outlook-Elements Zeigt, wie der Name des aktuellen Ordners und einige Informationen zum ausgewählten Element angezeigt werden.
  • Last updated on