SET INDEX-Befehl

Öffnet eine oder mehrere Indexdateien zur Verwendung mit der aktuellen Tabelle.

SET INDEX TO [IndexFileList | ? ] [ORDER nIndexNumber
 | IDXIndexFileName | [TAG] TagName [OF CDXFileName] [ASCENDING
 | DESCENDING]] [ADDITIVE]

Parameter

• IndexFileList
  Gibt eine oder mehrere zu öffnende Indexdateien an. Trennen Sie mehrere Indexdateien in der Liste mit Kommas. Die Indexdateiliste kann eine beliebige Kombination aus IDX- und CDX-Indexdateinamen enthalten. Die Dateierweiterungen für Indexdateien sind nur dann anzugeben, wenn eine IDX-Indexdatei und eine CDX-Indexdatei in der Indexdateiliste den gleichen Namen haben.

  Die erste Indexdatei der Liste wird zur Hauptindexdatei, d. h., sie steuert, wie auf Datensätze zugegriffen wird und wie diese angezeigt werden. Die Anzeige der Datensätze und der Zugriff auf dieselben erfolgt in der physikalischen Reihenfolge der Datensätze, wenn die erste Indexdatei eine CDX-Datei ist und der SET ORDER TO TAG-Befehl nicht eingegeben wurde.

• ?
  Zeigt das Dialogfeld Öffnen an, über das Sie eine einzelne IDX-Datei öffnen können.

• ORDER nIndexNumber
  Gibt eine Hauptindexdatei bzw. einen Hauptindexschlüssel an. Der numerische Ausdruck nIndexNumber gibt die Indexdateien so an, wie sie in der Indexdateiliste angezeigt werden.

  IDX-Dateien werden zunächst in der Reihenfolge nummeriert, in der sie in der Indexdateiliste angezeigt werden. Die Schlüssel in der strukturierten CDX-Datei (falls vorhanden) werden in der Reihenfolge nummeriert, in der die Schlüssel erstellt wurden. Schließlich werden die Schlüssel aller unabhängigen CDX-Dateien in der Reihenfolge nummeriert, in der sie erstellt wurden. Nähere Einzelheiten zum Nummerieren von Indexdateien und Indexschlüsseln finden Sie unter SET ORDER.

  Wenn nIndexNumber 0 ist, werden die Datensätze der Tabelle in ihrer physikalischen Reihenfolge angezeigt, und der Zugriff erfolgt ebenfalls in dieser Reihenfolge. Die Indexdateien bleiben jedoch geöffnet. ORDER 0 ermöglicht Ihnen, geöffnete Indexdateien zu aktualisieren, während auf Datensätze in physikalischer Reihenfolge zugegriffen wird. ORDER ohne weitere Argumente ist identisch mit dem ORDER 0-Befehl.

  Visual FoxPro generiert eine Fehlermeldung, wenn nIndexNumber größer ist als die Anzahl der IDX-Dateien und CDX-Dateischlüssel.

• ORDER IDXIndexFileName
  Gibt eine IDX-Datei als Hauptindexdatei an.

• ORDER [TAG] TagName [OF CDXFileName]
  Gibt den Schlüssel (TagName) aus einer CDX-Datei an, der den Hauptschlüssel darstellen soll. Der Schlüssel kann aus der strukturierten CDX-Datei oder einer geöffneten unabhängigen CDX-Datei stammen.

  Falls Schlüssel mit identischem Namen in geöffneten unabhängigen CDX-Dateien vorhanden sind, verwenden Sie OF CDXFileName, um die CDX-Datei anzugeben, in der sich der Schlüssel befindet.

• ASCENDING | DESCENDING
  Gibt an, ob Tabellendatensätze in aufsteigender oder absteigender Reihenfolge angezeigt werden und in welcher Reihenfolge der Zugriff auf die Datensätze erfolgt. Die Indexdateien oder Indexschlüssel selbst werden nicht geändert. Nur die Reihenfolge, in der die Datensätze angezeigt oder auf sie zugegriffen wird, ändert sich. Geben Sie ASCENDING oder DESCENDING unmittelbar nach der ORDER-Klausel an.

• ADDITIVE
  Gibt an, dass zuvor geöffnete Indexdateien, mit Ausnahme eines strukturierten Mehrfachindex, geöffnet bleiben, wenn Sie den SET INDEX-Befehl eingeben, um für eine Tabelle eine zusätzliche Indexdatei bzw. zusätzliche Indexdateien zu öffnen. Ohne ADDITIVE würden die zuvor geöffneten Dateien geschlossen werden.

Hinweise

Die Anzeige der Datensätze einer Tabelle, für die eine oder mehrere Indexdateien geöffnet sind, und der Zugriff auf diese Datensätze können in einer Reihenfolge erfolgen, die durch eine der Indexdateien bestimmt wird. Sowohl Einzelindexdateien (IDX) als auch Mehrfachindexdateien (CDX) können mit Hilfe von SET INDEX geöffnet werden. Besitzt eine Tabelle eine strukturierte CDX-Datei, wird diese Datei automatisch zusammen mit der Tabelle geöffnet.

Nur eine einzige IDX-Datei (die Hauptindexdatei) bzw. ein einziger Schlüssel (der Hauptindexschlüssel) einer CDX-Datei legt die Reihenfolge fest, in der die Anzeige der Datensätze der Tabelle bzw. der Zugriff auf diese Datensätze erfolgt. Bestimmte Befehle (beispielsweise SEEK) verwenden diese Hauptindexdatei beziehungsweise diesen Hauptindexschlüssel zur Datensatzsuche.

Das Eingeben von SET INDEX TO ohne weitere Argumente bewirkt das Schließen aller geöffneten Indexdateien (außer einer strukturierten CDX-Datei) im aktuellen Arbeitsbereich.

Siehe auch

CLOSE INDEXES | INDEX | SET ORDER | USE