Items.SetColumns, méthode (Outlook)

  • Article

Met en cache certaines propriétés pour un accès extrêmement rapide à ces propriétés particulières de chaque élément d’une collection Items .

Syntaxe

expression. SetColumns( _Columns_ )

Expression Variable qui représente un objet Items .

Parameters

Nom Requis/Facultatif Type de données Description
Colonnes Obligatoire String Chaîne qui contient les noms des propriétés à mettre en chache. Les noms de propriétés sont délimités par des virgules dans cette chaîne.

Remarques

La méthode SetColumns est utile pour procéder à une itération dans une collection Items. Si vous n’utilisez pas cette méthode, Microsoft Outlook doit ouvrir chaque élément pour accéder à la propriété . Avec la méthode SetColumns, Outlook vérifie uniquement les propriétés que vous avez placées en mémoire cache et fournit un accès rapide et en lecture seule à ces propriétés.

Après avoir appliqué la méthode SetColumns à des propriétés spécifiques de la collection, vous ne pouvez pas lire les autres propriétés de cette collection ; les propriétés qui ne sont pas mises en cache sont renvoyées vides. Vous n’avez pas non plus la possibilité d’écrire dans les propriétés de cette collection. Sinon, si vous avez besoin d’un accès rapide en lecture-écriture à un ensemble d’éléments, utilisez l’objet Table .

La méthode SetColumns ne peut pas être utilisée avec les propriétés qui renvoient un objet (une erreur sera générée). Elle ne peut pas être utilisée avec les propriétés suivantes :

AutoResolvedWinner InternetCodePage
BodyFormat MemberCount
Categories ReceivedByEntryID
Enfants ReceivedOnBehalfOfEntryID
Classe RecurrenceState
Companies ReplyRecipients
DLName ResponseState
DownloadState Saved
EntryID Sent
HTMLBody Submitted
IsConflict VotingOptions

La propriété ConversationIndex ne peut pas être mise en cache à l’aide de la méthode SetColumns. Toutefois, cette propriété ne génèrera pas d’erreur, contrairement aux autres propriétés répertoriées ci-dessus.

Exemple

L’exemple Visual Basic pour Applications (VBA) suivant utilise la collection Items pour obtenir les éléments du dossier Tâches par défaut, met en cache les propriétés Subject et DueDate , puis affiche l’objet et les dates d’échéance à tour de rôle.

Sub SortByDueDate() 
 
 Dim myNameSpace As Outlook.NameSpace 
 
 Dim myFolder As Outlook.Folder 
 
 Dim myItem As Object 
 
 Dim myItems As Outlook.Items 
 
 
 
 Set myNameSpace = Application.GetNamespace("MAPI") 
 
 Set myFolder = myNameSpace.GetDefaultFolder(olFolderTasks) 
 
 Set myItems = myFolder.Items 
 
 myItems.SetColumns ("Subject, DueDate") 
 
 For Each myItem In myItems 
 
 MsgBox myItem.Subject & " " & myItem.DueDate 
 
 Next myItem 
 
End Sub

Voir aussi

Éléments, 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.