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
Consulte Também
Exemplo das propriedades CursorType, LockType e EditMode (VB)
Exemplo das propriedades CursorType, LockType e EditMode (VC++)
Método Supports
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de