Share via


Filtrar elementos

Este tema describe las reglas generales para especificar las propiedades de los filtros que son compatibles con diversos objetos de Outlook. Para obtener más información sobre cómo especificar las condiciones de las propiedades para completar un filtro, vea los temas en la sección Sintaxis de filtros.

Un filtro es una condición o un conjunto de condiciones que puede aplicar a un conjunto de elementos para obtener un subconjunto de elementos que cumplan con las condiciones especificadas. Outlook es compatible con los filtros que usan la sintaxis de lenguaje de consulta Microsoft Jet o DASL (DAV Searching and Locating). Tenga en cuenta que la sintaxis del lenguaje de consulta Jet tiene la misma sintaxis que la que admite el Servicio de expresión de Microsoft Jet, de ahí el nombre de este lenguaje de consulta.

Por ejemplo, puede filtrar los elementos de contactos en la carpeta de Contactos para obtener una lista de contactos que residen en Canadá. En este caso, filtrará por la propiedad HomeAddressCountry . El filtro, que se expresa como filtro Jet, será "[HomeAddressCountry] = 'Canada'".

Outlook proporciona filtrado a través de los siguientes puntos de entrada:

Punto de entrada Compatible con filtro Jet Compatible con filtro DASL
Application.AdvancedSearch No
Folder.GetTable
Items.Find Sí. Tenga en cuenta que si usa las palabras clave de consulta ci_phrasematch o ci_startswith en el filtro, obtendrá un error.
Items.Restrict
Search.GetTable No
Table.FindRow Sí. Tenga en cuenta que si usa las palabras clave de consulta ci_phrasematch o ci_startswith en el filtro, obtendrá un error.
Table.Restrict
View.Filter No

Nota:

[!NOTA] Un filtro debe contener una consulta escrita en la sintaxis Jet o DASL, pero no una mezcla de ambas.

Especificadores de propiedad

Al especificar las propiedades de un filtro Jet o DASL mediante cualquiera de los puntos de entrada anteriores, siga estas instrucciones:

Filtro Jet Filtro DASL
Propiedades aplicables Propiedades explícitas integradas y personalizadas a nivel de elemento. Vea el tema del método correspondiente de propiedades no compatibles. Propiedades integradas y personalizadas a nivel de elemento con o sin nombres de cadena explícitos. Vea el tema del método correspondiente de propiedades no compatibles.
Hacer referencia a las propiedades
  • Con sus nombres de cadena explícitos.

  • A las propiedades integradas explícitas sólo se puede hacer referencia por su nombre en inglés, sin traducirlo a ningún otro idioma.

  • Se puede hacer referencia a las propiedades personalizadas por sus nombres en inglés o en un idioma localizado.

Con sus espacios de nombres.
Formato de la referencia
  • Incluyen nombres de cadena explícitos entre corchetes ("['']").

  • Los nombres de las propiedades no distinguen entre mayúsculas y minúsculas.

  • No se permiten espacios en las propiedades integradas explícitas.

  • Se permiten espacios en las propiedades personalizadas.

  • Todas las consultas DASL comienzan con un prefijo "@SQL =" que distingue mayúsculas de minúsculas, con la excepción de las consultas DASL para Application.AdvancedSearch.

  • La propiedad a la que se hace referencia por su espacio de nombres debe estar entre comillas dobles.

  • La propiedad a la que se hace referencia por su espacio de nombres sí distingue entre mayúsculas y minúsculas.

  • Si hay un espacio en el nombre de una propiedad personalizada, este debe sustituirse por "%20". En general, la codificación de direcciones URL se aplica de la misma manera a los caracteres de una consulta DASL que en una dirección URL.

Condiciones de error Devuelve un error si no se ha definido ninguna propiedad personalizada del filtro, o si el filtro está vacío, tiene un argumento no válido o no se puede analizar. Devuelve un error si no se ha definido ninguna propiedad personalizada del filtro, o si el filtro está vacío, tiene un argumento no válido o no se puede analizar.

Sintaxis de filtros

La sintaxis de un filtro depende del tipo de la propiedad que va a filtrar. En los temas siguientes encontrará más información sobre cómo construir un filtro basado en un tipo de propiedad concreto:

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.