Método Table.Restrict (Outlook)

Aplica un filtro a las filas de la tabla y obtiene un nuevo objeto Table.

Sintaxis

expresión. Restrict( _Filter_ )

Expresión Variable que representa un objeto Table .

Parameters

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
Filter	Obligatorio	String	Especifica los criterios para las filas del objeto Table.

Valor devuelto

Objeto Table que se devuelve aplicando Filter a las filas del objeto Table primario.

Comentarios

Sólo puede usar Table.Restrict para aplicar otro filtro a la tabla si el objeto primario de la tabla es un objeto Folder. Si el objeto primario es un objeto Search, Restrict devolverá un error.

Dado que el filtro se aplica a las filas del objeto Table , esto equivale a aplicar un filtro que es un AND lógico de Filter y todos los filtros anteriores aplicados al mismo objeto Table .

Filter es una consulta de propiedades especificadas de los elementos representados como filas en el objeto Table primario. La consulta usa la sintaxis de Microsoft Jet o la sintaxis DASL (DAV Searching and Locating). Por ejemplo, el siguiente filtro de Jet y el siguiente filtro DASL especifican los mismos criterios para los elementos cuyo valor de LastModificationTime sea anterior a 3:30 p.m. del 12 de junio de 2005:

criteria = "[LastModificationTime] < '" & Format$("6/12/2005 3:30PM","General Date") & "'"criteria = "@SQL=" & Chr(34) & "DAV:getlastmodified" & Chr(34) 
 & " < '" & Format$("6/12/2005 3:30PM","General Date") & "'" 

Para obtener más información sobre cómo especificar filtros para el objeto Table, vea Filtrar elementos.

Si Filter contiene propiedades personalizadas, esas propiedades deben existir en la carpeta primaria del objeto Table para que la restricción funcione correctamente. Algunas propiedades no se admiten en un filtro de tabla, como propiedades binarias, propiedades calculadas y contenido HTML o RTF. Para obtener más información, vea Propiedades no compatibles en un objeto Table o un filtro Table.

Si Filter es una cadena en blanco, Restrict devuelve un objeto Table idéntico al objeto Table primario.

Ejemplo:

El ejemplo de código siguiente aplica un filtro Jet en elementos de la Bandeja de entrada para obtener los elementos con un valor de LastModificationTime mayor que 1 de noviembre de 2005. Se imprimen, a continuación, los valores de las propiedades predeterminadas de estos elementos en la Bandeja de entrada: EntryID, Subject, CreationTime, LastModificationTime y MessageClass.

Nota:

[!NOTA] Dado que pueden haber elementos heterogéneos en la misma carpeta en Outlook, los elementos devueltos de aplicar el filtro a la Bandeja de entrada pueden ser de tipos diferentes. En general, antes de obtener acceso a todas las propiedades que no se encuentran entre las propiedades predeterminadas para los elementos de la Bandeja de entrada, debe comprobar el MessageClass del elemento.

Sub RestrictTable() 
 '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 November 1, 2005 
 Filter = "[LastModificationTime] > '11/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("EntryID")) 
 Debug.Print (oRow("Subject")) 
 Debug.Print (oRow("CreationTime")) 
 Debug.Print (oRow("LastModificationTime")) 
 Debug.Print (oRow("MessageClass")) 
 Loop 
End Sub

Consulte también

Objeto Table

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.