Objeto StorageItem (Outlook)
Um objeto de mensagem no MAPI que é sempre salvo como um item oculto na pasta pai e armazena dados particulares para soluções do Outlook.
Comentários
Um objeto StorageItem é armazenado no nível de pasta, permitindo que ele se movimentem com a conta e estar disponível online ou offline.
O modelo de objeto do Outlook não fornece qualquer objeto da coleção de objetos StorageItem. No entanto, você pode usar Folder.GetTable para obter uma Tabela com todos os itens ocultos em uma Pasta, quando especificar o parâmetro TableContents como olHiddenItems. Se manter seus dados particulares for uma preocupação alta, você deve criptografar os dados antes de armazená-lo.
Depois de obter um objeto StorageItem, você pode fazer o seguinte para armazenar dados de solução:
Adicionar anexos ao item para armazenamento.
Usar propriedades internas explícitas, como Body, para armazenar dados personalizados.
Adicione propriedades personalizadas para o item usando o método UserProperties. Observe que, nesse caso, os argumentos AddToFolderFields e DisplayFormat opcionais do método UserProperties.Add serão ignorados.
Use o objeto PropertyAccessor para obter ou definir propriedades personalizadas.
A classe de mensagem padrão para um novo StorageItem é IPM. Armazenamento. Se o StorageItem existente como uma mensagem oculta em uma versão do Outlook anteriores ao Microsoft Office Outlook 2007, a classe de mensagem permanecerá inalterada. Para impedir a modificação da classe de mensagem, StorageItem não expõe uma propriedade MessageClass explícita.
Para obter mais informações sobre como armazenar dados de solução usando o objeto StorageItem, consulte Armazenando dados de soluções.
Exemplo
O exemplo de código a seguir no Visual Basic for Applications mostra como usar o objeto StorageItem para armazenar dados particulares de solução. Ele salva os dados em uma propriedade personalizada de um objeto StorageItem na pasta caixa de entrada. O exemplo a seguir descreve as etapas.
O exemplo de código chama Folder. getstorage para obter um objeto StorageItem existente com o assunto "Meu Storage privada" na caixa de entrada. Se nenhum StorageItem com esse assunto já existir, o GetStorage cria um objeto StorageItem com esse assunto.
Se o StorageItem recém-criado, o exemplo de código cria uma propriedade personalizada "Order Number" para o objeto. Observe que "Order Number" é uma propriedade de um item oculto na caixa de entrada.
O exemplo de código, em seguida, atribui um valor a "Order Number" e salva o objeto 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étodos
| Nome |
|---|
| Delete |
| Save |
Propriedades
| Nome |
|---|
| Application |
| Anexos |
| Body |
| Classe |
| CreationTime |
| Creator |
| EntryID |
| LastModificationTime |
| Responsável |
| PropertyAccessor |
| Sessão |
| Tamanho |
| Subject |
| UserProperties |
Confira também
Referência de modelo de objeto do Outlook
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.