Compartilhar via


Filtrando itens usando palavras-chave de consulta

Use as seguintes palavras-chave de consulta apenas em consultas DASL (Pesquisa e Localização do DAV). As palavras-chave não diferenciam maiúsculas de minúsculas. O Microsoft Jet não oferece suporte a palavras-chave de consulta.

ci_startwith e ci_phrasematch

Essas palavras-chave do indexador de conteúdo fornecem prefixo e correspondência de frases, respectivamente, para itens em um repositório indexado. Por exemplo, a consulta DASL a seguir cria um filtro para sobrenome começando com "Smith" e usa uma palavra-chave do indexador de conteúdo para retornar os resultados:

  criteria = "@SQL=" & Chr(34) _ 
& "urn:schemas:contacts:sn" & Chr(34) _ 
& " ci_startswith 'Smith'"

A consulta DASL a seguir cria um filtro para o sobrenome sendo exatamente "Smith" e usa uma palavra-chave do indexador de conteúdo para retornar os resultados:

  criteria = "@SQL=" & Chr(34) _ 
& "urn:schemas:contacts:sn" & Chr(34) _ 
& " ci_phrasematch 'Smith'"

Is Null

Avalia se uma propriedade é nula. Retorna True se a propriedade é nula e False caso não seja nula.

As operações Is Null são úteis para determinar se uma propriedade de data foi definida ou se uma propriedade de sequência de caracteres está vazia. Se a data for nula, o valor da hora local da data será igual a 1/1/4501.

A sintaxe de Is Null é a seguinte, em que PropertyName é o nome de uma propriedade referenciada pelo namespace:

 [PropertyName] IS NULL

Você pode combinar palavras-chave Is Null com o operador Not para avaliar se uma propriedade não é nula.

A consulta DASL a seguir recupera todos os contatos em que a propriedade personalizada Order Date não é nula e a propriedade CompanyName é exatamente a Microsoft:

  criteria = "@SQL=" & "(NOT(" _ 
& Chr(34) & "https://schemas.microsoft.com/mapi/string/" _ 
& "{00020329-0000-0000-C000-000000000046}/Order%20Date" & Chr(34) _ 
& " IS NULL) AND " _ & Chr(34) & "urn:schemas-microsoft-com:office:office#Company" 
& Chr(34) _ & " = 'Microsoft')"

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.