Método Folder.GetTable (Outlook)

Obtiene un objeto Table que contiene elementos filtrados por Filter.

Sintaxis

expresión. GetTable( _Filter_ , _TableContents_ )

Expresión Variable que representa un objeto "Folder".

Parameters

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
Filter	Opcional	Cadena	Filtro de la sintaxis de búsqueda y localización (DASL) de Microsoft Jet o DAV que especifica los criterios para los elementos de la carpeta primaria.
TableContents	Opcional	OlTableContents	Especifica el tipo de elementos en la carpeta que GetTable devuelve un objeto. El valor predeterminado es olUserItems.

Valor devuelto

Objeto Table que contiene los elementos del objeto primario Folder que cumplen los criterios de Filter. De forma predeterminada, TableContents es olUserItems y el objeto Table devuelto contiene únicamente los elementos filtrados que no están ocultos.

Comentarios

Si Filter es una cadena en blanco o se omite el parámetro Filter , GetTable devuelve una tabla con filas que representan todos los elementos de la carpeta. Si Filter es una cadena en blanco o se omite el parámetro Filter y TableContents es olHiddenItems, GetTable devuelve una tabla con filas que representan todos los elementos ocultos de la carpeta.

Para obtener más información sobre los filtros, vea Filtrado de elementos y Referencia de propiedades por espacio de nombres.

GetTable devuelve una tabla con la columna predeterminada establecida para el tipo de carpeta del carpeta principal. Para modificar el conjunto de columnas predeterminado, use los métodos de Agregar, Quitar o RemoveAll del objeto de colección Columns. Cuando TableContents es olHiddenItems, el conjunto de columnas predeterminado siempre es el conjunto de columnas predeterminado para una carpeta de correo, aunque la carpeta principal podría ser, por ejemplo, una carpeta Contactos. Para obtener más información sobre los conjuntos de columnas predeterminados, vea Propiedades predeterminadas mostradas en un objeto Table.

Use Table.Restrict para aplicar filtros posteriores a una tabla basada en el objeto Folder .

Ejemplo:

El ejemplo de código siguiente ilustra cómo usar Folder.GetTable para obtener un objeto Table basándose en la propiedad LastModificationTime de los elementos de la Bandeja de entrada. A continuación, se enumeran y se imprimen los valores de un par de propiedades predeterminadas 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)  
  
    'Enumerate the table using test for EndOfTable  
    Do Until (oTable.EndOfTable)  
        Set oRow = oTable.GetNextRow()  
        Debug.Print (oRow("Subject"))  
        Debug.Print (oRow("LastModificationTime"))  
    Loop  
End Sub

Consulte también

Objeto Folder

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.