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:

• Filtering a Custom Field
• Filtering Items Using a Boolean Comparison
• Filtering Items Using a Comparison with a Keywords Property
• Filtering Items Using a Date-time Comparison
• Filtering Items Using a String Comparison
• Filtering Items Using a Variable
• Filtering Items Using an Integer Comparison
• Filtering Items Using Comparison and Logical Operators
• Filtering Items Using Query Keywords

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.