Partager via

Objet StorageItem (Outlook)

  • Article

Objet de message MAPI toujours enregistré en tant qu’élément masqué dans le dossier parent et qui stocke les données privées des solutions Outlook.

Remarques

Un objet StorageItem est enregistré au niveau du dossier, ce qui lui permet de suivre le compte et d'être disponible en ligne et hors connexion.

Le modèle objet Outlook ne fournit pas d’objet de collection pour les objets StorageItem. Toutefois, vous pouvez utiliser Folder.GetTable pour obtenir une table avec tous les éléments masqués dans un dossier, lorsque vous spécifiez le paramètre TableContents comme olHiddenItems. Si la confidentialité de vos données est primordiale, mieux vaut les chiffrer avant de les stocker.

Une fois que vous avez obtenu un objet StorageItem, vous pouvez procéder comme suit pour stocker les données de solution :

  • Ajoutez des pièces jointes à l'élément à stocker.

  • Utilisez des propriétés intégrées explicites de l’élément, telles que Body , pour stocker des données personnalisées.

  • Ajoutez des propriétés personnalisées à l’élément à l’aide de la méthode UserProperties.Add . Notez que dans ce cas, les arguments facultatifs AddToFolderFields et DisplayFormat de la méthode UserProperties.Add sont ignorés.

  • Utilisez l’objet PropertyAccessor pour obtenir ou définir des propriétés personnalisées.

La classe de message par défaut pour un nouvel objet StorageItem est IPM.Storage. Si l'objet StorageItem existait en tant que message masqué dans une version d'Outlook antérieure à Microsoft Office Outlook 2007, la classe de message reste inchangée. Pour empêcher la modification de la classe de message , l'objet StorageItem n'expose pas de propriété MessageClass explicite.

Pour plus d'informations sur le stockage des données de solution à l'aide de l'objet StorageItem, voir Stockage des données de solutions.

Exemple

L'exemple de code Visual Basic pour Applications suivant montre comment utiliser l'objet StorageItem pour enregistrer les données de solution privées. Il montre comment enregistrer les données dans une propriété personnalisée d'un objet StorageItem du dossier Boîte de réception. Voici la procédure utilisée.

  1. L’exemple de code appelle Folder.GetStorage pour obtenir un objet StorageItem existant dont l’objet est « Mon stockage privé » dans la boîte de réception. Si aucun objet StorageItem n’existe déjà, GetStorage crée un objet StorageItem avec cet objet.

  2. Si l'objet StorageItem vient d'être créé, l'exemple de code crée une propriété « Order Number » pour cet objet. Notez qu'il s'agit d'une propriété d'un élément masqué de la Boîte de réception.

  3. L’exemple de code affecte ensuite une valeur à « Numéro de commande » et enregistre l’objet StorageItem .

Sub AssignStorageData() 
 
 Dim oInbox As Outlook.Folder 
 
 Dim myStorage As Outlook.StorageItem 
 
 
 
 Set oInbox = Application.Session.GetDefaultFolder(olFolderInbox) 
 
 ' Get an existing instance of StorageItem, or create new if it doesn't exist 
 
 Set myStorage = oInbox.GetStorage("My Private Storage", olIdentifyBySubject) 
 
 ' If StorageItem is new, add a custom property for Order Number 
 
 If myStorage.Size = 0 Then 
 
 myStorage.UserProperties.Add "Order Number", olNumber 
 
 End If 
 
 ' Assign a value to the custom property 
 
 myStorage.UserProperties("Order Number").Value = 100 
 
 myStorage.Save 
 
End Sub

Méthodes

Nom
Delete
Save

Propriétés

Nom
Application
Attachments
Body
Class
CreationTime
Creator
EntryID
LastModificationTime
Parent
PropertyAccessor
Session
Size
Subject
UserProperties

Voir aussi

Référence du modèle objet Outlook

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.