Definições e valores de retorno

Define ou retorna um valor Long que pode ser definido como um dos valores CursorLocationEnum.

Comentários

Esta propriedade permite que você escolha entre várias bibliotecas de cursores acessíveis ao provedor. Em geral, você pode escolher entre usar uma biblioteca de cursores do lado do cliente ou uma localizada no servidor.

A definição dessa propriedade afeta as conexões estabelecidas somente depois que a propriedade for definida. Alterar a propriedade CursorLocation não afeta as conexões existentes.

Os cursores retornados pelo método Execute herdam essa configuração. Os objetos Recordset herdarão automaticamente essa configuração das conexões associadas.

Essa propriedade é leitura/gravação em um objeto Connection ou Recordset fechado e somente leitura em um Recordset aberto.

Define ou retorna um valor CursorTypeEnum. O valor padrão é adOpenForwardOnly.

Comentários

Use a propriedade CursorType para especificar o tipo de cursor que deve ser usado durante a abertura do objeto Recordset.

Só será dado suporte a uma configuração de adOpenStatic se a propriedade CursorLocation estiver definida como adUseClient, . Se um valor sem suporte for definido, não ocorrerá um erro. A propriedade CursorType com suporte mais próxima será usada em seu lugar.

Se um provedor não der suporte ao tipo de cursor solicitado, ele poderá retornar um outro tipo de cursor. A propriedade CursorType será alterada para que corresponda ao tipo de cursor real em uso quando o objeto Recordset for aberto. Para verificar a funcionalidade específica do cursor retornado, use o método Supports. Depois que o Recordset for fechado, a propriedade CursorType voltará à sua configuração original.

O gráfico a seguir mostra a funcionalidade do provedor (identificada pelas constantes do método Supports) necessária para cada tipo de cursor.

Em um Recordset desta CursorType  |  método Supports deve retornar True
                                                 |        para todas estas constantes
--------------------------------------------------------------------------
AdOpenForwardOnly                        | Nenhum
--------------------------------------------------------------------------
AdOpenKeyset                                   | adBookmark, adHoldRecords,
                                                              | adMovePrevious, adResync
--------------------------------------------------------------------------
AdOpenDynamic                                | AdMovePrevious
--------------------------------------------------------------------------
AdOpenStatic                                      | adBookmark, adHoldRecords,
                                                               | adMovePrevious, adResync
--------------------------------------------------------------------------

Observação   Embora Supports(adUpdateBatch) possa ser verdadeiro para cursores dinâmicos e apenas de avanço, nas atualizações em lotes você deve usar o cursor estático ou orientado a conjunto de teclas. Defina a propriedade LockType como adLockBatchOptimistic e a propriedade CursorLocation como adUseClient para ativar o Serviço de cursor para OLE DB, que é necessário para atualizações em lotes.

A propriedade CursorType é leitura/gravação quando o Recordset está fechado e somente leitura quando ele está aberto.