Partager via

Index, propriété

  • Article

Indique le nom de l’index actuellement en vigueur pour un objet Recordset.

Paramètres et valeurs de retour

Définit ou renvoie une valeur String, qui est le nom de l’index.

Notes

L’index nommé par la propriété Index doit avoir été déclaré précédemment sur la table de base sous-jacente à l’objet Recordset. Autrement dit, l’index doit avoir été déclaré par programmation en tant qu’objet ADOX Index ou lors de la création de la table de base.

Une erreur d’exécution se produit si l’index ne peut pas être défini. La propriété Index ne peut pas être définie dans les conditions suivantes :

  • Dans un gestionnaire d’événements WillChangeRecordset ou RecordsetChangeComplete.

  • Si le Recordset exécute toujours une opération (qui peut être déterminée par la propriété State).

  • Si un filtre a été défini sur l’objet Recordset avec la propriété Filter.

La propriété Index peut toujours être définie correctement si l’objet Recordset est fermé, mais que l’objet Recordset ne s’ouvre pas correctement ou si l’index n’est pas utilisable, si le fournisseur sous-jacent ne prend pas en charge les index.

Si l’index peut être défini, la position de ligne actuelle peut changer. Cela entraîne une mise à jour de la propriété AbsolutePosition et déclenche les événements WillChangeRecordset, RecordsetChangeComplete, WillMove et MoveComplete.

Si l’index peut être défini et que la propriété LockType est adLockPessimistic ou adLockOptimistic, une opération UpdateBatch implicite est effectuée. Cela libère les groupes actuels et affectés. Tout filtre existant est libéré et la position de ligne actuelle est remplacée par la première ligne de l’objet Recordset réorganisé.

La propriété Index est utilisée conjointement avec la méthode Seek. Si le fournisseur sous-jacent ne prend pas en charge la propriété Index et, par conséquent, la méthode Seek, envisagez d’utiliser la méthode Find à la place. Déterminez si l’objet Recordset prend en charge les index avec la méthode Supports(adIndex).

La propriété Index intégrée n’est pas liée à la propriété dynamique Optimize, bien qu’elles traitent tous les deux des index.

S'applique à

Recordset, objet (ADO)

Voir aussi

Seek (méthode) et Index (propriété), exemple (VB)
Index, objet (ADOX)
Seek, méthode