Objeto StorageItem (Outlook)

Objeto de mensaje en MAPI que siempre se guarda como elemento oculto en la carpeta principal y contiene datos privados de soluciones de Outlook.

Comentarios

Un objeto StorageItem se almacena en el nivel de carpeta para que puedan moverse con la cuenta y estar disponibles en línea o sin conexión.

El modelo de objetos de Outlook no proporciona ningún objeto de colección para los objetos StorageItem. Sin embargo, puede usar Folder.GetTable para obtener una tabla con todos los elementos ocultos en una carpeta, al especificar el parámetro TableContents como olHiddenItems. Si mantener la privacidad de los datos es de vital importancia, deberá cifrar los datos antes de almacenarlos.

Una vez que haya obtenido un objeto StorageItem, puede hacer lo siguiente para almacenar datos de soluciones:

• Agregar datos adjuntos al elemento para su almacenamiento.

• Usar propiedades explícitas integradas del elemento como Body para almacenar datos personalizados.

• Agregar propiedades personalizadas al elemento mediante el método UserProperties.Add. Tenga en cuenta que, en este caso, se omitirán los argumentos opcionales AddToFolderFields y DisplayFormat del método UserProperties.Add .

• Usar el objeto PropertyAccessor para obtener o definir propiedades personalizadas.

La clase de mensaje predeterminada para un nuevo objeto StorageItem es IPM de . Almacenamiento de información. Si el objeto StorageItem existía como mensaje oculto en una versión de Outlook anteriores a Microsoft Office Outlook 2007, no cambia la clase de mensaje. Con el fin de evitar la modificación de la clase de mensaje, el objeto StorageItem no expone una propiedad MessageClass explícita.

Para obtener más información sobre cómo almacenar datos de soluciones mediante el objeto StorageItem, vea Almacenar datos para soluciones.

Ejemplo:

El siguiente ejemplo de código en Visual Basic para aplicaciones muestra cómo usar el objeto StorageItem para almacenar datos privados de soluciones. Guarda los datos en una propiedad personalizada de un objeto StorageItem en la carpeta Bandeja de entrada. Lo siguiente describe los pasos.

1. El ejemplo de código llama a Folder.GetStorage para obtener un objeto StorageItem existente que tenga el asunto "My Private Storage" en la Bandeja de entrada. Si no existe ningún objeto StorageItem con ese asunto, GetStorage crea un objeto StorageItem con ese asunto.

2. Si el objeto StorageItem recién creado, el ejemplo de código crea una propiedad personalizada "Order Number" para el objeto. Tenga en cuenta que "Order Number" es una propiedad de un elemento oculto en la Bandeja de entrada.

3. A continuación, el código de ejemplo asigna un valor a "Order Number" y guarda el 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

Propiedades

Consulte también

Referencia del modelo de objetos de Outlook

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.