Objet Ligne (Outlook)

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

Remarques

Un tableau est composé de lignes et de colonnes. Il représente un ensemble de lignes de données dynamiques en lecture seule dans un dossier ou un objet de recherche . Vous pouvez considérer chaque ligne d’un tableau comme un élément du dossier, et chaque colonne comme une propriété de l’élément. Par défaut, la table ne contient qu’un sous-ensemble de propriétés pour les éléments du dossier. Cela fait de la table un ensemble de lignes léger en mémoire qui prend en charge l’énumération et le filtrage rapides des éléments dans le 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 de table : FindRow, FindNextRow, GetNextRow et MoveToStart pour obtenir une ligne spécifique dans une table.

Utilisez Row.GetValues pour obtenir un tableau de valeurs correspondant aux valeurs des colonnes de cette ligne dans la table.

Utilisez les fonctions d’assistance Row.BinaryToString, Row.LocalTimeToUTCetRow.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 de la table , vous devez obtenir l’ID d’entrée de cette ligne dans la colonne EntryID par défaut de la table , puis utiliser la méthode GetItemFromID de l’objet NameSpace pour obtenir un élément complet, tel qu’un MailItem ou un ContactItem, qui prend en charge les opérations en 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.