Objet StorageItem (Outlook)
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.
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.
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.
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.