Lire en anglais

Partager via


Objet Row (Outlook)

Représente une ligne de données dans l’objet Table .

Remarques

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.

Exemple

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

Méthodes

Propriétés

Voir aussi

Référence du modèle objet Outlook

Assistance et commentaires

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.