Objeto Row (Outlook)

Representa una fila de datos del objeto Table.

Comentarios

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.

Ejemplo:

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

Métodos

Nombre
BinaryToString
GetValues
Elemento
LocalTimeToUTC
UTCToLocalTime

Propiedades

Nombre
Aplicación
Class
Parent
Session

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.