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 namespaces. |
Formato de referência |
|
|
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.