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.
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.
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
Informations de référence sur le modèle objet Outlook des membres de l’objet Table
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.