Compartilhar via


Filtering Items

This topic describes the general rules for specifying properties in filters that are supported by various objects in Outlook. Para obter mais informações sobre como especificar condições nas propriedades para concluir um filtro, confira os tópicos na seção Sintaxe de Filtro .

Um filtro é uma condição ou um conjunto de condições que você pode aplicar a um conjunto de itens para obter um subconjunto de itens que atenda às condições especificadas. O Outlook dá suporte a filtros usando a sintaxe da linguagem de consulta do Microsoft Jet ou a sintaxe DASL (Pesquisa e Localização do DAV). Observe que a sintaxe da linguagem de consulta Jet é a mesma para a qual o Microsoft Jet Expression Service oferece suporte, por isso o nome de linguagem de consulta Jet.

Como exemplo, você pode filtrar itens de contato em sua pasta Contatos para obter uma lista dos contatos que residem no Canadá. Nesse caso, você estará filtrando na propriedade HomeAddressCountry . O filtro, expresso como um filtro Jet, será "[HomeAddressCountry] = 'Canada'".

O Outlook oferece filtragem por meio dos seguintes pontos de entrada:

Ponto de entrada Suporte ao filtro de jato Suporte ao filtro DASL
Application.AdvancedSearch Não Sim
Folder.GetTable Sim Sim
Itens.Localizar Sim Sim. Observe que se você usar as palavras-chave de consulta ci_phrasematch ou ci_startswith no filtro, você receberá um erro.
Itens.Restringir Sim Sim
Search.GetTable Não Sim
Table.FindRow Sim Sim. Observe que se você usar as palavras-chave de consulta ci_phrasematch ou ci_startswith no filtro, você receberá um erro.
Table.Restrict Sim Sim
Exibir.Filtrar Não Sim

Observação

[!OBSERVAçãO] A filter must contain a query in either Jet or DASL syntax but not a mixture of both.

Especificadores de propriedade

Ao especificar propriedades em um filtro Jet ou filtro DASL usando qualquer um dos pontos de entrada acima, siga estas diretrizes.

Filtro de jato Filtro DASL
Propriedades aplicáveis Propriedades de item internas e personalizadas mais explícitas; consulte o tópico do método correspondente para obter as propriedades sem suporte. Propriedades de item mais internas e personalizadas com e sem nomes explícitos de sequência de caracteres; consulte o tópico do método correspondente para obter as propriedades sem suporte.
Referenciando propriedades
  • Por seus nomes explícitos de sequência de caracteres.

  • As propriedades internas explícitas só podem ser referidas por seus nomes em inglês e não em qualquer outro idioma localizado.

  • As propriedades personalizadas podem ser referenciadas por seus nomes em inglês ou em um idioma localizado.

Por seus namespaces.
Formato de referência
  • Coloque os nomes explícitos de sequência de caracteres entre colchetes ('['']').

  • Os nomes de propriedade não diferenciam maiúsculas de minúsculas.

  • Não são permitidos espaços em propriedades internas explícitas.

  • São permitidos espaços em propriedades personalizadas.

  • Todas as consultas DASL começam com um prefixo que diferencia maiúsculas de minúsculas "@SQL=", com a exceção das consultas DASL de Application.AdvancedSearch.

  • A propriedade referida por namespace deve vir entre aspas duplas.

  • A propriedade referenciada pelo namespace é sensível a maiúsculas de minúsculas.

  • Se houver um espaço no nome de uma propriedade personalizada, ele deverá ser substituído por "%20". In general, URL encoding applies the same way to characters in a DASL query as in a URL.

Condições de erro Retorna um erro se uma propriedade personalizada do filtro não foi definida ou se o filtro está vazio, tem um argumento inválido ou não pode ser analisado. Retorna um erro se uma propriedade personalizada do filtro não foi definida ou o filtro está vazio, tem um argumento inválido ou não pode ser analisado.

Sintaxe do filtro

The syntax of a filter depends on the type of the property you are filtering on. Os tópicos a seguir fornecem mais informações sobre como construir um filtro com base em um tipo de propriedade específico:

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.