_Items.SetColumns(String) Méthode

Définition

Met en cache certaines propriétés d’un élément de la collection pour permettre d’y accéder très rapidement.

public:
 void SetColumns(System::String ^ Columns);
public void SetColumns (string Columns);
Public Sub SetColumns (Columns As String)

Paramètres

Columns
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 effectuer une itération au sein de la Items collection. 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 :

AutoResolvedWinnerInternetCodePage
CorpsMeetingWorkspaceURL
BodyFormat MemberCount
CatégoriesReceivedByEntryID
Children ReceivedOnBehalfOfEntryID
Classe RecurrenceState
SociétésReplyRecipients
DLName ResponseState
DownloadStateSaved
EntryIDSent
HTMLBodySubmitted
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.

S’applique à