Objeto Table (Outlook)

Representa un conjunto de datos de elementos de un objeto Folder o Search, donde los elementos son las filas de la tabla y las propiedades son las columnas de la tabla.

Comentarios

La tabla representa un sólo lectura conjunto dinámico de filas de datos en un objeto Folder o Search. Use Folder.GetTable o Search.GetTable para obtener un objeto Table que represente un conjunto de elementos en una carpeta o carpeta de búsqueda. Si el objeto Table se obtiene de Folder.GetTable, puede especificar otro filtro más (en Table.Restrict) para obtener un subconjunto de los elementos de la carpeta. Si no especifica ningún filtro, obtendrá todos los elementos de la carpeta.

De forma predeterminada, cada elemento de la tabla objeto devuelto contiene únicamente un subconjunto predeterminado de sus propiedades. Se pueden considerar cada fila de una tabla como un elemento de la carpeta, donde cada columna como una propiedad del elemento y la tabla como un conjunto de filas ligero en memoria que permite rapidez la enumeración y el filtrado de elementos de la carpeta. 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.

Para obtener más información sobre el objeto Table, vea Enumerar, buscar y filtrar elementos en una carpeta.

Ejemplo:

El siguiente ejemplo de código muestra cómo el objeto Table devuelve un conjunto filtrado de elementos basándose en la propiedad LastModificationTime. También se muestra cómo enumerar las propiedades predeterminadas, así como las propiedades específicas de los 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
FindNextRow
FindRow
GetArray
GetNextRow
GetRowCount
MoveToStart
Restrict
Sort

Propiedades

Nombre
Aplicación
Class
Columns
EndOfTable
Parent
Session

Consulte también

Referencia del modelo de objetos de Outlookpara miembros de objeto de tabla

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.