Table-Objekt (Outlook)

Artikel
04/07/2023

Stellt einen Satz Elementdaten aus einem Folder - oder Search -Objekt dar, wobei die Elemente die Zeilen der Tabelle und die Eigenschaften die Spalten der Tabelle darstellen.

HinwBemerkungeneise

Die Tabelle stellt ein Read-only dynamisches Rowset von Daten in einem Folder- oder Search -Objekt. Verwenden Sie Folder.GetTable oder Search.GetTable , um ein Table-Objekt abzurufen, das eine Gruppe von Elementen in einem Ordner oder Suchordner darstellt. Wenn das Table-Objekt mithilfe von Folder.GetTable abgerufen wurde, können Sie außerdem einen Filter angeben (in Table.Restrict), um eine Teilmenge der Elemente in diesem Ordner zu erhalten. Wenn Sie keinen Filter angeben, erhalten Sie alle Elemente im Ordner.

Standardmäßig enthält jedes Element in die zurückgegebene Tabelle nur einen Standard-Teil seiner Eigenschaften. Sie können jede Zeile einer Tabelle als Element im Ordner, jeder Spalte als eine Eigenschaft des Elements und der Tabelle als eine in-Memory-Rowset, das schnelle Enumeration ermöglicht und Filtern von Elementen im Ordner betrachten. Obwohl Hinzufügungen und Löschvorgänge des zugrunde liegenden Ordners durch die Zeilen der Tabelle wiedergegeben werden, unterstützt der Tabelle keine Ereignisse für das Hinzufügen, ändern und Löschen von Zeilen. Wenn Sie ein beschreibbaren-Objekt aus der Tabellenzeile benötigen, erhalten die Eintrags-ID für die Zeile aus der Standard-Eintrags-ID-Spalte in der Tabelle und dann die GetItemFromID -Methode des NameSpace -Objekts verwenden, um ein vollständiges Element abzurufen, wie ein MailItem-Objekt oder ein ContactItem-Objekt, unterstützt, die Lese-/ Schreibvorgänge. Weitere Informationen zu Standardspalten in einer Tabelle finden Sie unter Standardeigenschaften, die in einem Table-Objekt angezeigt werden.

Weitere Information über das Table-Objekt finden Sie unter Aufzählen, Suchen und Filtern von Elementen in einem Ordner.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie das Table -Objekt eine gefilterte Auswahl von Elementen basierend auf der LastModificationTime -Eigenschaft zurückgibt. Es wird gezeigt, wie die Standardeigenschaften sowie bestimmte Eigenschaften für die Elemente aufgelistet.

Sub DemoTable() 
 
 'Declarations 
 
 Dim Filter As String 
 
 Dim oRow As Outlook.Row 
 
 Dim oTable As Outlook.Table 
 
 Dim oFolder As Outlook.Folder 
 
 
 
 'Get a Folder object for the Inbox 
 
 Set oFolder = Application.Session.GetDefaultFolder(olFolderInbox) 
 
 
 
 'Define Filter to obtain items last modified after May 1, 2005 
 
 Filter = "[LastModificationTime] > '5/1/2005'" 
 
 'Restrict with Filter 
 
 Set oTable = oFolder.GetTable(Filter) 
 
 
 
 'Remove all columns in the default column set 
 
 oTable.Columns.RemoveAll 
 
 'Specify desired properties 
 
 With oTable.Columns 
 
 .Add ("Subject") 
 
 .Add ("LastModificationTime") 
 
 'PR_ATTR_HIDDEN referenced by the MAPI proptag namespace 
 
 .Add ("http://schemas.microsoft.com/mapi/proptag/0x10F4000B") 
 
 End With 
 
 
 
 'Enumerate the table using test for EndOfTable 
 
 Do Until (oTable.EndOfTable) 
 
 Set oRow = oTable.GetNextRow() 
 
 Debug.Print (oRow("Subject")) 
 
 Debug.Print (oRow("LastModificationTime")) 
 
 Debug.Print (oRow("http://schemas.microsoft.com/mapi/proptag/0x10F4000B")) 
 
 Loop 
 
End Sub

Methoden

Name
FindNextRow
FindRow
GetArray
GetNextRow
GetRowCount
MoveToStart
Restrict
Sort

Eigenschaften

Name
Anwendung
Klasse
Columns
EndOfTable
Parent
Session

Siehe auch

Elemente des Tabellenobjekts : Outlook-Objektmodellreferenz

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Freigeben über