Объект StorageItem (Outlook)
Объект сообщения в MAPI, который всегда сохраняется как скрытый элемент в родительской папке и хранит личные данные для решений Outlook.
Замечания
Объект StorageItem хранится на уровне папки, что позволяет ему перемещаться с учетной записью и быть доступным в сети или в автономном режиме.
Объектная модель Outlook не предоставляет объект коллекции для объектов StorageItem . Однако вы можете использовать Folder.GetTable для получения таблицы со всеми скрытыми элементами в папке при указании параметра TableContents как olHiddenItems. Если сохранение конфиденциальности данных имеет большое значение, необходимо зашифровать данные перед их хранением.
Получив объект StorageItem , можно выполнить следующие действия для хранения данных решения:
Добавьте вложения к элементу для хранения.
Используйте явные встроенные свойства элемента, например Текст , для хранения пользовательских данных.
Добавьте настраиваемые свойства в элемент с помощью метода UserProperties.Add . Обратите внимание, что в этом случае необязательные аргументы AddToFolderFields и DisplayFormat метода UserProperties.Add будут игнорироваться.
Используйте объект PropertyAccessor для получения или задания пользовательских свойств.
Класс сообщений по умолчанию для нового storageItem — IPM. Хранилище. Если StorageItem существовал в виде скрытого сообщения в версии Outlook до Microsoft Office Outlook 2007, класс сообщения останется неизменным. Чтобы предотвратить изменение класса сообщений, StorageItem не предоставляет явное свойство MessageClass .
Дополнительные сведения о хранении данных решения с помощью объекта StorageItem см. в разделе Хранение данных для решений.
Пример
В следующем примере кода в Visual Basic для приложений показано, как использовать объект StorageItem для хранения данных частного решения. Данные сохраняются в пользовательском свойстве объекта StorageItem в папке "Входящие". Ниже описаны шаги.
Пример кода вызывает Folder.GetStorage для получения существующего объекта StorageItem с темой "Мое частное хранилище" в папке "Входящие". Если элемент StorageItem с этим субъектом уже не существует, GetStorage создает объект StorageItem с этим субъектом .
Если объект StorageItem создан, в примере кода создается пользовательское свойство "Номер заказа" для объекта . Обратите внимание, что "Номер заказа" — это свойство скрытого элемента в папке "Входящие".
Затем в примере кода присваивается значение "Номер заказа" и сохраняется объект 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
Методы
| Имя |
|---|
| Delete |
| Save |
Свойства
| Имя |
|---|
| Application |
| Attachments |
| Body |
| Class |
| CreationTime |
| Creator |
| EntryID |
| LastModificationTime |
| Parent |
| PropertyAccessor |
| Session |
| Size |
| Subject |
| UserProperties |
См. также
Справочник по объектной модели Outlook
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.