Row-Objekt (Outlook)
Stellt eine Zeile mit Daten in einem Table -Objekt dar.
HinwBemerkungeneise
Eine Tabelle besteht aus Zeilen und Spalten. Es stellt ein nur-Lese-dynamisches Rowset von Daten in einem Folder- oder Search -Objekt. Jede Zeile einer Tabelle kann als ein Element in den Ordner, und jede Spalte als Eigenschaft des Elements angesehen werden. Standardmäßig enthält die Tabelle nur eine Teilmenge der Eigenschaften für Elemente im Ordner. Dadurch wird die Tabelle zu einem in-Memory-Rowset, das schnelles Aufzählen und Filtern von Elementen im Ordner unterstützt.
Wenn das Table-Objekt von Folder.GetTable abgerufen wird, können Sie einen Filter (in Table.Restrict) festlegen, um eine weiter eingegrenzte Gruppe von Zeilen im Table-Objekt zu erhalten.
Verwenden Sie die Table-Methoden FindRow, FindNextRow, GetNextRow und MoveToStart , um eine bestimmte Zeile in einer Tabelle abzurufen.
Verwenden Sie Row.GetValues, um ein Array von Werten zu erhalten, die Spaltenwerte Row-Objekts in der Tabelle entsprechen.
Verwenden Sie die Hilfsfunktionen Row.BinaryToString, Row.LocalTimeToUTC und Row.UTCToLocalTime, um die typenkonvertierung von Spaltenwerten in einer bestimmten Zeile zu vereinfachen. Weitere Informationen zur Darstellung von Eigenschaftswerten in einem Table-Objekt finden Sie unter Faktoren, die sich auf die Darstellung von Eigenschaftswerten in den Klassen 'Table' und 'View' auswirken.
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.
Beispiel
Das folgende Codebeispiel veranschaulicht, wie ein Table -Objekt basierend auf der LastModificationTime von Elementen im Posteingang zu erhalten. Es zeigt auch zum Anpassen von Spalten in der Tabelle, und wie aufgelistet und die Werte der entsprechenden Eigenschaften dieser Elemente gedruckt.
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 |
|---|
| BinaryToString |
| GetValues |
| Element |
| LocalTimeToUTC |
| UTCToLocalTime |
Eigenschaften
| Name |
|---|
| Anwendung |
| Klasse |
| Parent |
| Session |
Siehe auch
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.