Objet Row (Outlook)
Représente une ligne de données dans l’objet Table .
Une table est composée de lignes et de colonnes. Il représente un ensemble de lignes dynamique en lecture seule de données dans un objet Folder ou Search . Vous pouvez considérer chaque ligne d’une table comme un élément dans le dossier, et chaque colonne comme une propriété de l’élément. Par défaut, la table contient uniquement un sous-ensemble de propriétés pour les éléments du dossier. Cela fait de table un ensemble de lignes léger en mémoire qui prend en charge l’énumération et le filtrage rapides des éléments du dossier.
Si l'objet Table est obtenu à partir de Folder.GetTable, vous pouvez spécifier un filtre (dans la méthode Table.Restrict) pour obtenir un ensemble de lignes plus restreint dans l'objet Table.
Utilisez les méthodes Table : FindRow, FindNextRow, GetNextRow et MoveToStart pour obtenir une ligne spécifique dans une table.
Utilisez Row.GetValues pour obtenir un tableau de valeurs qui correspondent aux valeurs de colonne de cette ligne dans la table.
Utilisez les fonctions d’assistance Row.BinaryToString, Row.LocalTimeToUTC et Row.UTCToLocalTime pour faciliter la conversion de type des valeurs de colonne sur une ligne spécifique. Pour plus d’informations sur la représentation des valeurs des propriétés dans l’objet Table, voir Facteurs influant sur la représentation des valeurs de propriétés dans les classes Table et View.
Bien que les ajouts et les suppressions du dossier sous-jacent soient représentés par les lignes de l’objet Table, l’objet Table ne prend en charge aucun événement d’ajout, de modification et de suppression de lignes. Si vous avez besoin d’un objet accessible en écriture à partir de la ligne Table , obtenez l’ID d’entrée de cette ligne à partir de la colonne EntryID par défaut dans la table , puis utilisez la méthode GetItemFromID de l’objet NameSpace pour obtenir un élément complet, tel qu’un objet MailItem ou ContactItem, qui prend en charge les opérations de lecture-écriture. Pour plus d’informations sur les colonnes par défaut d’un objet Table, voir Propriétés par défaut affichées dans un objet Table.
L'exemple de code suivant montre comment obtenir un objet Table basé sur l'heure de dernière modification des éléments exprimée par LastModificationTime dans la boîte de réception. Il montre également comment personnaliser les colonnes de la table et comment énumérer et imprimer les valeurs des propriétés correspondantes de ces éléments.
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
Référence du modèle objet Outlook
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.