Méthode Seek (ADO)
S’applique à : Access 2013, Office 2013
Effectue une recherche dans l’index d’un objet Recordset pour retrouver rapidement la ligne qui correspond aux valeurs spécifiées et faire de cette ligne la position de ligne active.
Syntaxe
recordset. SeekKeyValues, SeekOption
Paramètres
Paramètre | Description |
---|---|
Valeurs de clés | Tableau de valeurs de type Variant. Un index se compose d'une ou plusieurs colonnes et le tableau contient une valeur à comparer à chaque colonne correspondante. |
SeekOption | Valeur SeekEnum qui spécifie le type de comparaison à effectuer entre les colonnes de l’index et les ValeursClés correspondantes. |
Remarques
Il est conseillé d’utiliser conjointement la méthode Seek avec la propriété Index si le fournisseur sous-jacent prend les index en charge sur l’objet Recordset. La méthode Supports(adSeek) permet de déterminer si le fournisseur sous-jacent prend Seek en charge, et la méthode Supports(adIndex) de déterminer si les index sont pris en charge par le fournisseur. (Par exemple, le fournisseur OLE DB pour Microsoft Jet prend Seek et Index en charge.)
Si la méthode Seek ne trouve pas la ligne recherchée, aucune erreur n'est générée et la ligne est positionnée à la fin du Recordset. Veillez à définir la propriété Index sur l'index souhaité avant d'exécuter cette méthode.
Cette méthode n'est prise en charge qu'avec des curseurs côté serveur. Seek n'est pas prise en charge lorsque la valeur de la propriété CursorLocation de l'objet Recordset est adUseClient.
Vous ne pouvez employer cette méthode que dans le seul cas où l'objet Recordset a été ouvert avec une valeur adCmdTableDirect pour CommandTypeEnum.