Compartilhar via

O conjunto de registros: Classificar registros (ODBC)

  • Artigo

Este tópico se aplica às classes MFC ODBC.

Este tópico explica como classificar registros. Você pode especificar uma ou mais colunas no qual basear a classificação e você pode especificar a ordem crescente ou decrescente (ASC ou DESC; ASCé o padrão) para cada coluna de especificado. Por exemplo, se você especificar duas colunas, os registros são classificados pela primeira vez na primeira coluna nomeada e, em seguida, na segunda coluna nomeada. Um SQL ORDER BY cláusula define uma classificação. Quando o framework acrescenta o ORDER BY cláusula SQL do conjunto de registros de consulta, os controles de cláusula a seleção da ordenação.

Você deve estabelecer a ordem de classificação do conjunto de registros após você construir o objeto, mas antes de chamar seu Abrir a função de membro (ou antes de chamar o Requery a função de membro de um conjunto de registros existente de objeto cuja Abrir a função de membro foi chamada anteriormente).

Para especificar uma ordem de classificação para um objeto recordset

  1. Construir um novo objeto recordset (ou se preparar para chamar Requery para um já existente).

  2. Definir o valor do objeto m_strSort o membro de dados.

    A classificação é uma seqüência terminada por caractere nulo. Ele contém o conteúdo na ORDER BY cláusula mas não a palavra-chave ORDER BY. Por exemplo, use:

    recordset.m_strSort = "LastName DESC, FirstName DESC";

    não

    recordset.m_strSort = "ORDER BY LastName DESC, FirstName DESC";

  3. Defina outras opções que você precisa, como, por exemplo, um filtro, o modo de bloqueio ou parâmetros.

  4. Chame Abrir para o novo objeto (ou Requery para um objeto existente).

Os registros selecionados são ordenados conforme especificado. Por exemplo, para classificar um conjunto de registros de alunos em ordem decrescente por sobrenome e nome, faça o seguinte:

// Construct the recordset
CStudentSet rsStudent( NULL );
// Set the sort
rsStudent.m_strSort = "LastName DESC, FirstName DESC";
// Run the query with the sort in place
rsStudent.Open( );

O conjunto de registros contém todos os registros do aluno, classificados em ordem decrescente (Z a) pelo sobrenome, em seguida, pelo primeiro nome.

ObservaçãoObservação

Se você optar por substituir a seqüência de caracteres do conjunto de registros padrão SQL, passando a sua própria seqüência de SQL para Abrir, não defina uma classificação se a seqüência de caracteres personalizada tem um ORDER BY cláusula.

Consulte também

Conceitos

O conjunto de registros (ODBC)

O conjunto de registros: Parametrização de um conjunto de registros (ODBC)

O conjunto de registros: Filtragem de registros (ODBC)