Objet Table (Outlook)

Représente un ensemble de données d’élément à partir d’un objet Folder ou Search , avec des éléments sous forme de lignes de la table et des propriétés en tant que colonnes de la table.

Remarques

L'objet Table représente un ensemble dynamique de lignes de données en lecture seule dans un objet Folder ou Search. Utilisez Folder.GetTable ou Search.GetTable pour obtenir un objet Table qui représente un ensemble d’éléments dans un dossier ou un dossier de recherche. Si l'objet Table est obtenu à partir de la méthode Folder.GetTable, vous pouvez spécifier un filtre (dans la méthode Table.Restrict) pour obtenir un sous-ensemble des éléments du dossier. Si vous ne spécifiez aucun filtre, vous obtiendrez tous les éléments du dossier.

Par défaut, chaque élément renvoyé avec l’objet Table ne contient qu’un sous-ensemble par défaut de ses propriétés. Vous pouvez considérer chaque ligne d’une table comme un élément dans le dossier, chaque colonne comme une propriété de l’élément et table comme un ensemble de lignes léger en mémoire qui permet une énumération et un filtrage rapides des éléments du dossier. 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.

Pour plus d'informations sur l'objet Table, voir Énumération, recherche et filtrage d'éléments dans un dossier.

Exemple

L'exemple de code suivant montre comment l'objet Table peut renvoyer un ensemble d'éléments filtré en fonction de leur propriété LastModificationTime. Il montre également comment établir la liste des propriétés par défaut et des propriété spécifiques des é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

Nom
FindNextRow
FindRow
GetArray
GetNextRow
GetRowCount
MoveToStart
Restrict
Sort

Propriétés

Nom
Application
Class
Columns
EndOfTable
Parent
Session

Voir aussi

Informations de référence sur le modèle objet Outlook des membres de l’objet Table

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.