Partager via

Index, propriété (ADO)

  • Article

S’applique à : Access 2013, Office 2013

Indique le nom de l'index utilisé pour un objet Recordset.

Paramètres et valeurs de retour

Définit ou renvoie une valeur String indiquant le nom de l'index.

Remarques

L'index nommé par la propriété Index doit avoir été préalablement déclaré sur la table de base sous-jacente de l'objet Recordset. C'est-à-dire que l'index doit avoir été déclaré par programmation soit sous forme d'objet Index ADOX, soit au moment de la création de la table de base.

Une erreur d'exécution est générée si l'index ne peut pas être défini. La propriété Index ne peut pas être définie :

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

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

  • Si un filtre a été défini sur le Recordset par la propriété Filter.

La propriété Index peut toujours être définie avec succès si le Recordset est fermé, mais le Recordset ne s'ouvre pas correctement (ou 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, il se peut que la position de la ligne active soit modifiée. Cela provoque la mise à jour de la propriété AbsolutePosition et la génération des événements WillChangeRecordset, RecordsetChangeComplete, WillMove et MoveComplete.

Si l'index peut être défini et que la valeur de la propriété LockType est adLockPessimistic ou adLockOptimistic, une opération UpdateBatch implicite est réalisée. Cela libère le groupe actuel et le groupe attribué. S'il existe un filtre, il est libéré, et la ligne active devient la première ligne du Recordset réorganisé.

La propriété Index est utilisée en association 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 ), pensez à utiliser plutôt la méthode Find. 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'a aucun rapport avec la propriété Optimize dynamique, même si toutes deux portent sur les index.