Freigeben über

Index-Eigenschaft (ADO)

  • Artikel

Gilt für: Access 2013, Office 2013

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

Einstellungen und Rückgabewerte

Legt den Indexnamen als String-Wert fest oder gibt den Wert zurück.

Hinweise

Der durch die Index-Eigenschaft benannte Index muss zuvor für die 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 in folgenden Fällen nicht festgelegt werden:

  • Innerhalb eines WillChangeRecordset- oder eines RecordsetChangeComplete-Ereignishandlers.

  • Während das Recordset-Objekt noch eine Operation ausführt (was mithilfe der State-Eigenschaft ermittelt werden kann).

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

Die Index -Eigenschaft kann immer fehlerfrei festgelegt werden, wenn das Recordset -Objekt geschlossen ist. Wenn der zugrunde liegende Anbieter jedoch keine Indizes unterstützt, wird das Recordset -Objekt nicht fehlerfrei geöffnet, oder der Index kann nicht verwendet werden.

Wenn der Index festgelegt werden kann, ändert sich möglicherweise die aktuelle Zeilenposition. Dadurch wird die AbsolutePosition-Eigenschaft aktualisiert und die Ereignisse WillChangeRecordset, RecordsetChangeComplete, WillMove und MoveComplete werden generiert.

Wenn der Index festgelegt werden kann und die LockType-Eigenschaft auf AdLockPessimistic oder AdLockOptimistic festgelegt ist, wird eine implizite UpdateBatch-Operation ausgeführt. Dadurch werden die aktuellen und betroffenen Gruppen freigegeben. Alle vorhanden Filter werden freigegeben, und die aktuelle Zeilenposition wird zur ersten Zeile des neu angeordneten Recordset -Objekts.

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

Die integrierte Index-Eigenschaft hängt nicht mit der dynamischen Optimize-Eigenschaft zusammen, obwohl sich beide auf Indizes beziehen.