Index-Eigenschaft

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

Einstellungen und Rückgabewerte

Legt einen String-Wert fest, oder gibt einen solchen zurück, der der Name des Indexes ist.

Bemerkungen

Der mit der Index-Eigenschaft benannte Index 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 Index-Eigenschaft kann unter folgenden Bedingungen nicht festgelegt werden:

  • In einem WillChangeRecordset- oder RecordsetChangeComplete-Ereignishandler.

  • Wenn das Recordset noch einen Vorgang ausführt (was mit der State-Eigenschaft ermittelt werden kann).

  • Wenn ein Filter für das Recordset mit der Filter-Eigenschaft festgelegt wurde.

Die Index-Eigenschaft kann immer erfolgreich festgelegt werden, wenn das Recordset geschlossen wird, aber das Recordset lässt sich nicht erfolgreich öffnen, oder der Index ist nicht verwendbar, wenn der zugrunde liegende Anbieter keine Indizes 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 die Ereignisse WillChangeRecordset, RecordsetChangeComplete, WillMove und MoveComplete aus.

Wenn der Index festgelegt werden kann und die LockType-Eigenschaft den Wert adLockPessimistic oder adLockOptimistic hat, wird ein impliziter UpdateBatch-Vorgang ausgeführt. Dadurch werden die aktuellen und betroffenen Gruppen freigegeben. Jeder vorhandene Filter wird freigegeben, und die aktuelle Zeilenposition wird in die erste Zeile des neu angeordneten Recordset geändert.

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

Die integrierte Index-Eigenschaft steht in keinem Bezug zu der dynamischen Optimize-Eigenschaft, obwohl beide Indizes verarbeiten.

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

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