Partager via


Propriété d’index

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.

Remarques

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 lorsque la table de base a été créée.

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 l’objet 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 l’objet Recordset ne s’ouvre pas correctement, ou l’index ne sera 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 du jeu d’enregistrements 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 donc 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é Dynamic Optimize , bien qu’elle traite tous deux des index.

S’applique à

objet Recordset (ADO)

Voir aussi

Seek, méthode et index, exemple de propriété (VB)
adoX (Index Object)
méthode Seek