Compartilhar via


CRecordset::m_strFilter

Depois que você constrói o objeto do conjunto de registros, mas antes de chamar a função de membro de Abrir , use esse membro de dados para armazenar CString que contém uma cláusula SQL WHERE .

Comentários

O conjunto de registros usa essa cadeia de caracteres para restringir (ou filtro) registros que seleciona ou Abrir durante a chamada de Requery . Isso é útil para selecionar um subconjunto de registros, como “todos os vendedores baseados em Califórnia estado” (“”). = CA A sintaxe ODBC SQL para uma cláusula de WHERE é

WHERE search-condition

Observe que você não inclui a palavra-chave de WHERE na cadeia de caracteres. A estrutura oferece.

Você também pode parametrizar a cadeia de caracteres filtro colocando “?” os espaços reservados em ele, declarando um membro de dados do parâmetro em sua classe para cada espaço reservado, e passando parâmetros para o conjunto de registros em tempo de execução. Isso permite que você crie em tempo de execução o filtro. Para obter mais informações, consulte o artigo conjunto de registros: Parameterizing um recordset (ODBC).

Para obter mais informações sobre as cláusulas SQL WHERE , consulte o artigo O SQL. Para obter mais informações sobre como selecionar e de filtrar registros, consulte o artigo conjunto de registros: Filtrando registros (ODBC).

Exemplo

CCustomer rsCustSet(&m_dbCust);

// Set the filter
rsCustSet.m_strFilter = _T("L_Name = 'Flanders'");

// Run the filtered query
rsCustSet.Open(CRecordset::snapshot, _T("Customer"));

Requisitos

Cabeçalho: afxdb.h

Consulte também

Referência

Classe CRecordset

Gráfico da hierarquia

CRecordset::m_strSort

CRecordset::Requery