Edit

Recordset: Sorting Records (ODBC)

  • Article

This topic applies to the MFC ODBC classes.

This topic explains how to sort your recordset. You can specify one or more columns on which to base the sort, and you can specify ascending or descending order (ASC or DESC; ASC is the default) for each specified column. For example, if you specify two columns, the records are sorted first on the first column named and then on the second column named. A SQL ORDER BY clause defines a sort. When the framework appends the ORDER BY clause to the recordset's SQL query, the clause controls the selection's ordering.

You must establish a recordset's sort order after you construct the object but before you call its Open member function (or before you call the Requery member function for an existing recordset object whose Open member function has been called previously).

To specify a sort order for a recordset object

  1. Construct a new recordset object (or prepare to call Requery for an existing one).

  2. Set the value of the object's m_strSort data member.

    The sort is a null-terminated string. It contains the contents of the ORDER BY clause but not the keyword ORDER BY. For example, use:

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

    not

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

  3. Set any other options you need, such as a filter, locking mode, or parameters.

  4. Call Open for the new object (or Requery for an existing object).

The selected records are ordered as specified. For example, to sort a set of student records in descending order by last name, then first name, do the following:

// 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( );

The recordset contains all of the student records, sorted in descending order (Z to A) by last name, then by first name.

Note

If you choose to override the recordset's default SQL string by passing your own SQL string to Open, do not set a sort if your custom string has an ORDER BY clause.

See also

Recordset (ODBC)
Recordset: Parameterizing a Recordset (ODBC)
Recordset: Filtering Records (ODBC)