Interface ISearchQueryHelper (searchapi.h)

Fornece métodos para criar uma consulta a partir da entrada do usuário, converter uma consulta no SQL de Pesquisa do Windows e obter um cadeia de conexão para inicializar uma conexão com o índice pesquisa de janela.

Herança

A interface ISearchQueryHelper herda da interface IUnknown . ISearchQueryHelper também tem estes tipos de membros:

Métodos

A interface ISearchQueryHelper tem esses métodos.

ISearchQueryHelper::GenerateSQLFromUserQuery Gera uma consulta de linguagem SQL (SQL) com base em uma cadeia de caracteres de consulta fornecida pelo cliente expressa na Sintaxe de Consulta Avançada (AQS) ou na Sintaxe de Consulta Natural (NQS).
ISearchQueryHelper::get_ConnectionString Retorna o cadeia de conexão OLE DB para o índice pesquisa de janela.
ISearchQueryHelper::get_QueryContentLocale Obtém o LCID (identificador de código de idioma) para a consulta.
ISearchQueryHelper::get_QueryContentProperties Obtém a lista de propriedades incluídas na consulta quando os termos de pesquisa não especificam explicitamente uma propriedade.
ISearchQueryHelper::get_QueryKeywordLocale Obtém o LCID (identificador de código de idioma) para a localidade usar ao analisar palavras-chave AQS (Sintaxe de Consulta Avançada).
ISearchQueryHelper::get_QueryMaxResults Obtém o número máximo de resultados a serem retornados pela consulta.
ISearchQueryHelper::get_QuerySelectColumns Obtém as colunas (ou propriedades) solicitadas na instrução SELECT da consulta.
ISearchQueryHelper::get_QuerySorting Obtém a ordem de classificação para o conjunto de resultados da consulta.
ISearchQueryHelper::get_QuerySyntax Obtém a sintaxe da consulta.
ISearchQueryHelper::get_QueryTermExpansion Obtém o valor que especifica como os termos de consulta devem ser expandidos.
ISearchQueryHelper::get_QueryWhereRestrictions Obtém as restrições acrescentadas a uma consulta em cláusulas WHERE.
ISearchQueryHelper::p ut_QueryContentLocale Define o LCID (identificador de código de idioma) da consulta.
ISearchQueryHelper::p ut_QueryContentProperties Define as propriedades a serem incluídas na consulta se os termos de pesquisa não especificarem explicitamente as propriedades.
ISearchQueryHelper::p ut_QueryKeywordLocale Define o LCID (identificador de código de idioma) para a localidade a ser usada ao analisar palavras-chave AQS (Sintaxe de Consulta Avançada).
ISearchQueryHelper::p ut_QueryMaxResults Define o número máximo de resultados a serem retornados por uma consulta.
ISearchQueryHelper::p ut_QuerySelectColumns Define as colunas (ou propriedades) solicitadas na instrução select.
ISearchQueryHelper::p ut_QuerySorting Define a ordem de classificação para o conjunto de resultados da consulta.
ISearchQueryHelper::p ut_QuerySyntax Define a sintaxe da consulta.
ISearchQueryHelper::p ut_QueryTermExpansion Define um valor que especifica como os termos de consulta devem ser expandidos.
ISearchQueryHelper::p ut_QueryWhereRestrictions Define as restrições acrescentadas a uma consulta em cláusulas WHERE.
ISearchQueryHelper::WriteProperties Não implementado. (ISearchQueryHelper.WriteProperties)

Comentários

Essa interface é obtida chamando ISearchCatalogManager::GetQueryHelper. Implemente essa interface como uma classe auxiliar para ISearchCatalogManager.

Essa interface facilita a geração de consultas SQL usando a Sintaxe de Consulta Avançada (AQS) ou a Sintaxe de Consulta Natural (NQS). Os clientes podem enviar a consulta SQL para o mecanismo de Pesquisa de Janela usando OLE DB ou Microsoft ActiveX Data Objects (ADO).

ISearchQueryHelper::GenerateSQLFromUserQuery usa configurações de localidade regional. No entanto, ISearchQueryHelper não usa as configurações de localidade regional. Como resultado, há inconsistências no SQL retornado de ISearchQueryHelper::GenerateSQLFromUserQuery e ISearchQueryHelper para configurações específicas da região, como formatos de data, por exemplo.

Para obter um exemplo que demonstra como criar uma classe para um aplicativo de console estático para consultar o Windows Search usando o assembly Microsoft.Search.Interop para ISearchQueryHelper, consulte o exemplo de DSearch .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	searchapi.h
Redistribuível	Pesquisa da Área de Trabalho do Windows (WDS) 3.0

Confira também

Consulta do índice de maneira programática

Consultando o índice com a sintaxe do SQL da Pesquisa do Windows