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.