Méthode Folder.GetTable (Outlook)

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

Syntaxe

expression. GetTable( _Filter_ , _TableContents_ )

expression Variable qui représente un objet « Dossier ».

Paramètres

Nom	Requis/Facultatif	Type de données	Description
Filter	Facultatif	String	Filtre de la syntaxe de recherche et de localisation Microsoft Jet ou DAV (DASL) qui spécifie les critères des éléments du dossier parent.
Table des matières	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 (Filtrer ) est une chaîne vide ou si le paramètre Filtre est omis, GetTable renvoie une table avec des lignes représentant tous les éléments du dossier. Si Filter (Filtrer ) est une chaîne vide ou si le paramètre Filtre est omis et que TableContents est exprimé en olHiddenItems, GetTable renvoie une table avec des lignes représentant tous les éléments masqués du dossier.

Pour plus d’informations sur les filtres, voir Filtrer les éléments et Référencer les 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 l’ensemble 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 Dossier .

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.