Objeto Row (Outlook)
Representa una fila de datos del objeto Table.
Una tabla se compone de filas y columnas. Representa un solo lectura conjunto dinámico de filas de datos en un objeto Folder o Search. Cada fila de una tabla se puede considerar como un elemento de la carpeta y cada columna como una propiedad del elemento. De forma predeterminada, la tabla contiene sólo un subconjunto de las propiedades de los elementos de la carpeta. Esto hace que la tabla de un conjunto de filas ligero en memoria compatible con rapidez la enumeración y el filtrado de elementos de la carpeta.
Si el objeto Table se obtiene de Folder.GetTable, puede especificar otro filtro más (en Table.Restrict) para obtener un conjunto de filas más limitado en el objeto Table.
Use los métodos Table: FindRow, FindNextRow, GetNextRow y MoveToStart para obtener una fila específica en una tabla.
Utilice Row.GetValues para obtener una matriz de valores que corresponden a los valores de la columna de esa fila en la tabla.
Utilice las funciones Row.BinaryToString, Row.LocalTimeToUTC y Row.UTCToLocalTime para facilitar la conversión de tipos de valores de columna de una fila concreta. Para obtener más información sobre la representación de los valores de las propiedades en un objeto Table, vea Factores que afectan a la representación de los valores de las propiedades en las clases Table y View.
Aunque las adiciones y eliminaciones de la carpeta subyacente se reflejan en las filas de la tabla, la tabla no admite eventos para agregar, cambiar y quitar filas. Si necesita una fila de Table, obtener el identificador de entrada de la fila del valor predeterminado EntryID de columna en la tabla y, a continuación, utilizar el método GetItemFromID del objeto NameSpace para obtener el elemento completo, como MailItem o ContactItem, admite operaciones de lectura y escritura. Para obtener más información sobre las propiedades predeterminadas de un objeto Table, consulte el tema sobre las propiedades predeterminadas mostradas en un objeto Table.
En el siguiente ejemplo de código se ilustra cómo obtener un objeto Table basándose en la propiedad LastModificationTime de los elementos de la Bandeja de entrada. También se muestra cómo personalizar las columnas de la tabla y cómo enumerar e imprimir los valores de las propiedades correspondientes de estos elementos.
Sub DemoTable()
'Declarations
Dim Filter As String
Dim oRow As Outlook.Row
Dim oTable As Outlook.Table
Dim oFolder As Outlook.Folder
'Get a Folder object for the Inbox
Set oFolder = Application.Session.GetDefaultFolder(olFolderInbox)
'Define Filter to obtain items last modified after May 1, 2005
Filter = "[LastModificationTime] > '5/1/2005'"
'Restrict with Filter
Set oTable = oFolder.GetTable(Filter)
'Remove all columns in the default column set
oTable.Columns.RemoveAll
'Specify desired properties
With oTable.Columns
.Add ("Subject")
.Add ("LastModificationTime")
'PR_ATTR_HIDDEN referenced by the MAPI proptag namespace
.Add ("http://schemas.microsoft.com/mapi/proptag/0x10F4000B")
End With
'Enumerate the table using test for EndOfTable
Do Until (oTable.EndOfTable)
Set oRow = oTable.GetNextRow()
Debug.Print (oRow("Subject"))
Debug.Print (oRow("LastModificationTime"))
Debug.Print (oRow("http://schemas.microsoft.com/mapi/proptag/0x10F4000B"))
Loop
End Sub
Nombre |
---|
Aplicación |
Class |
Parent |
Session |
Referencia del modelo de objetos de Outlook
¿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.