Método CompareBookmarks (ADO)

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

Sintaxe

  
result = recordset.CompareBookmarks(Bookmark1, Bookmark2)  

Valor retornado

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

Parâmetros

Bookmark1
O indicador da primeira linha.

Bookmark2
O indicador da segunda linha.

Comentários

Os indicadores precisam ser aplicados ao mesmo objeto Recordset ou a um objeto Recordset e seu clone. Você não pode comparar indicadores de diferentes objetos Recordset de maneira confiável, 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 uma Variant. Por exemplo, indicadores do SQL Server são do tipo DBTYPE_R8 (Double). O ADO exporia esse tipo como uma Variant com um subtipo Double.

Ao comparar indicadores, o ADO não tenta nenhum tipo de coerção. Os valores são simplesmente transmitidos ao provedor em que a comparação ocorre. Se os indicadores transmitidos ao 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 uns com os outros".

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

Aplica-se A

Objeto Recordset (ADO)

Consulte Também

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