Freigeben über


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

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.