Méthode Folder.GetTable (Outlook)

Article
04/07/2023

Obtient un objet Table qui contient des éléments filtrés par Filter.

Syntaxe

expression. GetTable( _Filter_ , _TableContents_ )

Expression Variable qui représente un objet « Folder ».

Parameters

Nom	Requis/Facultatif	Type de données	Description
Filter	Facultatif	String	Filtre dans la syntaxe DASL (Microsoft Jet ou DAV Searching and Locating) qui spécifie les critères pour les éléments du dossier parent.
TableContents	Facultatif	OlTableContents	Spécifie le type des éléments dans le dossier renvoyé par GetTable. La valeur par défaut est olUserItems.

Valeur renvoyée

Objet Table contenant des éléments dans l’objet Folder parent qui répondent aux critères de Filter. Par défaut, TableContents correspond à olUserItems et l’objet Table renvoyé contient uniquement les éléments filtrés non masqués.

Remarques

Si Filter est une chaîne vide ou si le paramètre Filter est omis, GetTable renvoie une table avec des lignes représentant tous les éléments du dossier. Si Filter est une chaîne vide ou si le paramètre Filter est omis et que TableContents a la valeur olHiddenItems, GetTable renvoie une table avec des lignes représentant tous les éléments masqués dans le dossier.

Pour plus d’informations sur les filtres, consultez Filtrage d’éléments et Référencement des propriétés par espace de noms.

GetTable renvoie un objet Table avec l’ensemble de colonnes par défaut défini pour le type de dossier de l’objet Folder parent. Pour modifier le jeu de colonnes par défaut, utilisez les méthodes Add, Remove ou RemoveAll de l’objet de collection Columns . Lorsque TableContents a la valeur olHiddenItems, la colonne par défaut définie est toujours la colonne par défaut d’un dossier de messagerie même si l’objet Folder parent est, par exemple, un dossier Contacts. Pour plus d’informations sur les jeux de colonnes par défaut, voir Propriétés par défaut affichées dans un objet Table.

Utilisez Table.Restrict pour appliquer les filtres suivants à une table basée sur l’objet Folder .

Exemple

L'exemple de code suivant montre comment utiliser Folder.GetTable pour obtenir un objet Table basé sur la LastModificationTime des éléments de la boîte de réception. Ce code permet d'énumérer et d'imprimer ensuite les valeurs des propriétés par défaut 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)  
  
    'Enumerate the table using test for EndOfTable  
    Do Until (oTable.EndOfTable)  
        Set oRow = oTable.GetNextRow()  
        Debug.Print (oRow("Subject"))  
        Debug.Print (oRow("LastModificationTime"))  
    Loop  
End Sub

Voir aussi

Folder, objet

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.

Partager via