_Application.AdvancedSearch(String, Object, Object, Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Realiza uma pesquisa com base em uma sequência de pesquisa do DAV Searching and Locating (DASL) especificada.

public Microsoft.Office.Interop.Outlook.Search AdvancedSearch (string Scope, object Filter, object SearchSubFolders, object Tag);

Public Function AdvancedSearch (Scope As String, Optional Filter As Object, Optional SearchSubFolders As Object, Optional Tag As Object) As Search

Parâmetros

Scope

String

O escopo da pesquisa. Por exemplo, o caminho de pasta de uma pasta. É recomendável que o caminho da pasta esteja entre aspas simples. Caso contrário, talvez a pesquisa não retorne resultados corretos se o caminho da pasta contiver caracteres especiais (como caracteres Unicode, por exemplo). Para especificar vários caminhos de pasta, coloque cada caminho de pasta entre aspas simples e separe os caminhos de pasta com aspas simples com vírgula.

Filter

Object

O filtro de pesquisa DASL que define os parâmetros da pesquisa.

SearchSubFolders

Object

Determina se a pesquisa será feita também em subpastas da pasta.

Tag

Object

O nome dado como identificador para a pesquisa.

Retornos

Search

Um Search objeto que representa os resultados da pesquisa.

Comentários

Você pode executar várias pesquisas simultaneamente chamando o método AdvancedSearch em linhas sucessivas de código. No entanto, você deve estar ciente de que criar programaticamente um grande número de pastas de pesquisa pode resultar em atividade significativa pesquisa simultâneas que seria afetam o desempenho do Outlook, especialmente se o Outlook conduz a pesquisa no modo online do Exchange.

O método AdvancedSearch e recursos relacionados no modelo de objeto do Outlook não crie uma pasta de pesquisa que irá aparecer na interface de usuário do Outlook. No entanto, pode utilizar o Save(String) método do objeto Procurar que é devolvido para criar uma Pasta de Pesquisa que será apresentada na lista Pastas de Pesquisa na interface de utilizador do Outlook.

Com o Scope parâmetro , pode especificar uma ou mais pastas no mesmo arquivo, mas pode não especificar múltiplas pastas em vários arquivos. Para especificar várias pastas para o Scope parâmetro, utilize um caráter de vírgula entre cada caminho de pasta e coloque cada caminho de pasta entre plicas. Para pastas padrão, como caixa de entrada ou itens enviados, você pode usar o nome da pasta simples em vez do caminho de pasta completa. Por exemplo, as seguintes linhas de código representam parâmetros válidos Scope :

Dim Scope As String = "'Inbox', 'Sent Items'" string Scope = "'Inbox', 'Sent Items'";

Dim Scope1 As String = "'" & Application.Session.GetDefaultFolder( _
    Outlook.OlDefaultFolders.olFolderInbox).FolderPath & _
    "','" & Application.Session.GetDefaultFolder( _
    Outlook.OlDefaultFolders.olFolderSentMail).FolderPath

string Scope1 = "'" + Application.Session.GetDefaultFolder( 
    Outlook.OlDefaultFolders.olFolderInbox).FolderPath + 
    "','" + Application.Session.GetDefaultFolder( 
    Outlook.OlDefaultFolders.olFolderSentMail).FolderPath;

O Filter parâmetro pode ser qualquer consulta DASL válida. Para obter informações adicionais sobre consultas DASL, veja Filtrar Itens e Referenciar Propriedades por Espaço de Nomes. Tenha em atenção que não pode utilizar uma consulta JET para o Filter parâmetro da Pesquisa Avançada. Se a Pesquisa Instantânea estiver ativada num arquivo que contenha uma pasta especificada no Scope parâmetro , pode utilizar palavras-chave de Pesquisa Instantânea para melhorar o desempenho da sua pesquisa. Se você usar palavras-chave de pesquisa instantânea e pesquisa instantânea não está habilitada, o Outlook retornará que um erro e sua pesquisa falhará.