Método CompareBookmarks (ADO)

Aplica-se ao: Access 2013, Office 2013

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

Sintaxe

Resultado = conjunto de registros. CompareBookmarks(Bookmark1, Bookmark2)

Valor de retorno

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

Parâmetros

Parâmetro	Descrição
Indicador1	O indicador da primeira linha.
Indicador2	O indicador da segunda linha.

Comentários

Os indicadores devem ser aplicados ao mesmo objeto Recordset, ou a um objeto Recordset e seu clone. Não é possível comparar com segurança indicadores de objetos Recordset diferentes, mesmo se eles foram criados a partir da mesma fonte ou comando. Também não é possível comparar indicadores para um objeto Recordset cujo provedor base não suporte comparações.

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

Como o tipo de dados de um indicador é específico do provedor, o ADO o expõe como uma Variant. Por exemplo, indicadores do SQL Server são do tipo DBTYPE_R8 (Double). O ADO exporá esse tipo como uma Variant com um subtipo igual a Double.

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

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