Propriedade Sort

Indica um ou mais nomes de campo nos quais o conjunto de registros é classificado e se cada campo é classificado em ordem crescente ou decrescente.

Configurações e valores retornados

Define ou retorna um valor String que indica os nomes de campo no conjunto de registros no qual classificar. Cada nome é separado por uma vírgula e, opcionalmente, é seguido por uma palavra-chave em branco, ASC, que classifica o campo em ordem crescente ou DESC, que classifica o campo em ordem decrescente. Por padrão, se nenhuma palavra-chave for especificada, o campo será classificado em ordem crescente.

Observações

Essa propriedade requer que a propriedade CursorLocation seja definida como adUseClient. Um índice temporário será criado para cada campo especificado na propriedade Classificar se um índice ainda não existir.

A operação de classificação é eficiente porque os dados não são reorganizados fisicamente, mas são simplesmente acessados na ordem especificada pelo índice.

Quando o valor da propriedade Sort for diferente de uma cadeia de caracteres vazia, a ordem de propriedade classificação terá precedência sobre a ordem especificada em uma cláusula ORDER BY incluída na instrução SQL usada para abrir o Recordset.

O Recordset não precisa ser aberto antes de acessar a propriedade de Classificação; ele pode ser definido a qualquer momento depois que o objeto Recordset for instanciado.

Definir a propriedade Classificar como uma cadeia de caracteres vazia redefinirá as linhas para sua ordem original e excluirá índices temporários. Os índices existentes não serão excluídos.

Suponha que um Recordset contenha três campos chamados firstName, middleInitiale lastName. Defina a propriedade Classificar como a cadeia de caracteres, "lastName DESC, firstName ASC", que ordenará o conjunto de registros por sobrenome em ordem decrescente e, em seguida, pelo nome em ordem crescente. A inicial do meio é ignorada.

Nenhum campo pode ser chamado de "ASC" ou "DESC" porque esses nomes entram em conflito com as palavras-chave ASC e DESC. Você pode criar um alias para um campo com um nome conflitante usando a palavra-chave AS na consulta que retorna o conjunto de registros .

Aplica-se a

do objeto Recordset (ADO)

Consulte Também

exemplo da propriedade de classificação (VB)
exemplo da propriedade de classificação (VC++)
otimizar Property-Dynamic (ADO)
propriedade SortColumn (RDS)
propriedade SortDirection (RDS)