Método Items.SetColumns (Outlook)

Copia en caché algunas propiedades para obtener un acceso muy rápido a dichas propiedades correspondientes a un elemento incluido en la colección Items.

Sintaxis

expresión. SetColumns( _Columns_ )

Expresión Variable que representa un objeto Items .

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
Columns Obligatorio String Una cadena que contiene los nombres de las propiedades para copiar en caché. Los nombres de las propiedades están delimitados por comas en esta cadena.

Comentarios

El método SetColumns es útil para iterar a través de una colección de elementos. Si no utiliza este método, Microsoft Outlook debe abrir cada elemento para tener acceso a la propiedad. Con el método SetColumns, Outlook sólo comprueba las propiedades que se almacenado en caché y proporciona acceso rápido y de sólo lectura a estas propiedades.

Después de aplicar el método SetColumns en propiedades específicas de la colección, no se puede leer otras propiedades de esa colección; las propiedades que no se almacenan en caché se devuelven vacías. No se puede escribir en cualquiera de las propiedades de esa colección ya sea. Como alternativa, si necesita acceso de lectura y escritura y rápido a un conjunto de elementos, utilice el objeto Table.

SetColumns no se puede utilizar y generará un error, con cualquier propiedad que devuelve un objeto. No se pueden utilizar con las siguientes propiedades:

AutoResolvedWinner InternetCodePage
BodyFormat MemberCount
Categorías ReceivedByEntryID
Children ReceivedOnBehalfOfEntryID
Clase RecurrenceState
Companies ReplyRecipients
DLName ResponseState
DownloadState Saved
EntryID Sent
HtmlBody submitted
IsConflict VotingOptions

La propiedad ConversationIndex no se puede almacenar en caché mediante el método SetColumns. Sin embargo, esta propiedad no se producirá un error como las otras propiedades enumeradas anteriormente.

Ejemplo:

La versión siguiente de Visual Basic para aplicaciones (VBA) utiliza la colección Items para obtener los elementos de forma predeterminada en carpeta de tareas, almacena en caché las propiedades Subject y DueDate y, a continuación, se muestra al asunto y las fechas de vencimiento por turnos.

Sub SortByDueDate() 
 
 Dim myNameSpace As Outlook.NameSpace 
 
 Dim myFolder As Outlook.Folder 
 
 Dim myItem As Object 
 
 Dim myItems As Outlook.Items 
 
 
 
 Set myNameSpace = Application.GetNamespace("MAPI") 
 
 Set myFolder = myNameSpace.GetDefaultFolder(olFolderTasks) 
 
 Set myItems = myFolder.Items 
 
 myItems.SetColumns ("Subject, DueDate") 
 
 For Each myItem In myItems 
 
 MsgBox myItem.Subject & " " & myItem.DueDate 
 
 Next myItem 
 
End Sub

Consulte también

Objeto Items

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.