Propriedade CursorType (ADO)

Indica o tipo de cursor usado em um objeto Recordset.

Configurações e valores retornados

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 ao abrir o objeto Recordset.

Somente uma configuração de adOpenStatic terá suporte se a propriedade CursorLocation estiver definida como adUseClient. Se um valor sem suporte for definido, nenhum erro será disparado; em vez disso, o CursorType com suporte mais próximo será usado.

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

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

Para um Recordset desse CursorType	O 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 somente de encaminhamento, no caso de atualizações em lote você deve usar um conjunto de chaves ou um cursor estático. Defina a propriedade LockType como adLockBatchOptimistic e a propriedade CursorLocation como adUseClient para habilitar o Cursor Service para OLE DB, que é necessário para atualizações em lote.

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

Observação

Uso do Remote Data Service Quando usada em um objeto Recordset do lado do cliente, a propriedade CursorType só pode ser definida como adOpenStatic.

Aplica-se A

Objeto Recordset (ADO)

Consulte Também

Exemplo das propriedades CursorType, LockType e EditMode (VB)
Exemplo das propriedades CursorType, LockType e EditMode (VC++)
Método Supports