Freigeben über

Index-Eigenschaft

  • Artikel

Gibt den Namen des Indexes an, der derzeit für ein Recordset -Objekt wirksam ist.

Einstellungen und Rückgabewerte

Dient zum Festlegen oder Zurückgeben eines String Werts, bei dem es sich um den Namen des Indexes handelt.

Bemerkungen

Der index, der von der Index-Eigenschaft benannt wurde, muss zuvor in der Basistabelle deklariert worden sein, die dem Recordset-Objekt zugrunde liegt. Das heißt, der Index muss programmgesteuert entweder als ADOX-Index--Objekt oder beim Erstellen der Basistabelle deklariert worden sein.

Wenn der Index nicht festgelegt werden kann, tritt ein Laufzeitfehler auf. Die eigenschaft Index kann nicht unter den folgenden Bedingungen festgelegt werden:

  • Innerhalb eines WillChangeRecordset oder RecordsetChangeComplete Ereignishandlers.

  • Wenn das Recordset- weiterhin einen Vorgang ausführt (der durch die eigenschaft State bestimmt werden kann).

  • Wenn für das Recordset ein Filter festgelegt wurde, mit der eigenschaft Filter.

Die eigenschaft Index kann immer erfolgreich festgelegt werden, wenn das Recordset- geschlossen wird, das Recordset jedoch nicht erfolgreich geöffnet wird oder der Index nicht verwendet werden kann, wenn der zugrunde liegende Anbieter Indizes nicht unterstützt.

Wenn der Index festgelegt werden kann, kann sich die aktuelle Zeilenposition ändern. Dies führt zu einer Aktualisierung der AbsolutePosition--Eigenschaft und löst das WillChangeRecordset, RecordsetChangeComplete, WillMoveund MoveComplete Ereignisse aus.

Wenn der Index festgelegt werden kann und die LockType--Eigenschaft adLockPessimistic oder adLockOptimisticist, wird ein impliziter UpdateBatch Vorgang ausgeführt. Dadurch werden die aktuellen und betroffenen Gruppen freigegeben. Ein vorhandener Filter wird freigegeben, und die aktuelle Zeilenposition wird in die erste Zeile des neu angeordneten Recordsetgeändert.

Die Index-Eigenschaft wird in Verbindung mit der Seek-Methode verwendet. Wenn der zugrunde liegende Anbieter die Index--Eigenschaft und damit die Seek-Methode nicht unterstützt, sollten Sie stattdessen die Find-Methode verwenden. Bestimmen Sie, ob das Recordset-Objekt Indizes mit der Supports(adIndex)-Methode unterstützt.

Die integrierte Index--Eigenschaft ist nicht mit der dynamischen Optimize-Eigenschaft verknüpft, obwohl beide Indizes betreffen.

Gilt für

Recordset-Objekt (ADO)

Siehe auch

Seek-Methode und Index-Eigenschaft (VB-Beispiel)
Index-Objekt (ADOX)
Seek-Methode