Compartilhar via


Método Seek

Procura o índice de um Recordset para localizar rapidamente a linha que corresponde aos valores especificados e altera a posição da linha atual para essa linha.

Sintaxe

  
recordset.Seek KeyValues, SeekOption  

Parâmetros

KeyValues
Uma matriz de valores Variant. Um índice consiste em uma ou mais colunas e a matriz contém um valor a ser comparado com cada coluna correspondente.

SeekOption
Um valor SeekEnum que especifica o tipo de comparação a ser feito entre as colunas do índice e os KeyValues correspondentes.

Comentários

Use o método Seek em conjunção com a propriedade Index se o provedor subjacente der suporte a índices no objeto Recordset. Use o método Supports(adSeek) para determinar se o provedor subjacente dá suporte ao método Seek e o método Supports(adIndex) para determinar se o provedor dá suporte a índices. (Por exemplo, o Provedor OLE DB para Microsoft Jet dá suporte a Seek e Index.)

Se Seek não encontrar a linha desejada, nenhum erro ocorrerá e a linha será posicionada no final do Recordset. Defina a propriedade Index como o índice desejado antes de executar esse método.

Esse método tem suporte apenas com cursores do lado do servidor. O Seek não tem suporte quando o valor da propriedade CursorLocation do objeto Recordset é adUseClient.

Esse método só pode ser usado quando o objeto Recordset foi aberto com um valor CommandTypeEnum de adCmdTableDirect.

Aplica-se A

Objeto Recordset (ADO)

Consulte Também

Exemplo da propriedade Index e do método Seek (VB)
Exemplo da propriedade Index e do método Seek (VC++)
Método Find (ADO)
Propriedade Index