Método CompareBookmarks (ADO)

Compara dois indicadores e retorna uma indicação de seus valores relativos.

Sintaxe

  
result = recordset.CompareBookmarks(Bookmark1, Bookmark2)  

Valor retornado

Retorna um valor CompareEnum que indica a posição relativa da linha de dois registros representados por seus indicadores.

Parâmetros

Bookmark1
O indicador da primeira linha.

Bookmark2
O indicador da segunda linha.

Observações

Os indicadores devem ser aplicados ao mesmo objeto recordset ou a um objeto Recordset e seu clonar. Você não pode comparar de forma confiável indicadores de diferentes objetos Recordset, mesmo que eles tenham sido criados com base na mesma origem ou comando. Também não é possível comparar indicadores para um objeto Recordset cujo provedor subjacente não dá suporte a comparações.

Um indicador identifica exclusivamente uma linha em um objeto Recordset. Use a propriedade Bookmark da linha atual para obter seu indicador.

Como o tipo de dados de um indicador é específico para cada provedor, o ADO o expõe como um Variant. Por exemplo, os indicadores do SQL Server são do tipo DBTYPE_R8 (double). O ADO exporia esse tipo como um Variant com um subtipo de double.

Ao comparar indicadores, o ADO não tenta nenhum tipo de coerção. Os valores são simplesmente passados para o provedor em que a comparação ocorre. Se os indicadores passados para o método CompareBookmarks forem armazenados em variáveis de tipos diferentes, ele poderá gerar o seguinte erro de incompatibilidade de tipo: "Os argumentos são do tipo errado, estão fora do intervalo aceitável ou estão em conflito entre si".

Um indicador não válido ou formado incorretamente causará um erro.

Aplica-se a

do objeto Recordset (ADO)

Consulte Também

exemplo do método CompareBookmarks (VB)
Exemplo do método CompareBookmarks (VC++)
propriedade Bookmark (ADO)