Método Seek (ADO)
Aplica-se ao: Access 2013, Office 2013
Pesquisa o índice de um Recordset para localizar rapidamente a linha que corresponde aos valores especificados e altera a posição de linha atual para essa linha.
Sintaxe
conjunto de registros. BuscarKeyValues, SeekOption
Parâmetros
| Parâmetro | Descrição |
|---|---|
| KeyValues | Uma matriz de valores Variant. Um índice consiste em uma ou mais colunas e a matriz contém um valor a ser comparado em relação a cada coluna correspondente. |
| SeekOption | Um valor SeekEnum que especifica o tipo de comparação a ser feita entre as colunas do índice e os KeyValues correspondentes. |
Comentários
Use o método Seek junto com a propriedade Index se o provedor subjacente oferecer suporte aos índices no objeto Recordset. Use o método Supports(adSeek) para determinar se o provedor subjacente oferece suporte ao método Seek e o método Supports(adIndex) para determinar se o provedor oferece suporte aos índices. (Por exemplo, o OLE DB Provider for Microsoft Jet oferece suporte a Seek e Index.)
Se Seek não localizar a linha desejada, nenhum erro ocorrerá e a linha será posicionada no final do Recordset. Defina a propriedade Index para o índice desejado antes de executar este método.
Este método é suportado apenas com os cursores do lado do servidor. Seek não é suportado quando o valor da propriedade CursorLocation do objeto Recordset for adUseClient.
Este método pode ser utilizado apenas quando o objeto Recordset foi aberto com um CommandTypeEnum com o valor adCmdTableDirect.