Share via

Objeto StorageItem (Outlook)

  • Artigo

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.

  1. 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.

  2. 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.

  3. 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.