ADBOBJECTS( )-Funktion

Schreibt die Namen von benannten Verbindungen, Beziehungen, Tabellen und SQL-Ansichten der aktuellen Datenbank in ein Array.

ADBOBJECTS(ArrayName, cSetting)

Rückgabewerte

Numerisch

Parameter

• ArrayName
  Gibt den Namen des Arrays an, in das die Namen geschrieben werden. Wenn das angegebene Array nicht vorhanden ist, wird es von Visual FoxPro automatisch erstellt. Ist das Array vorhanden, aber nicht groß genug, um alle Namen aufzunehmen, passt Visual FoxPro die Größe des Arrays automatisch an die Anzahl der Namen an. Ist das Array größer als notwendig, wird es abgeschnitten. Wenn das Array vorhanden ist und ADBOBJECTS( ) 0 zurückgibt, weil keine Namen gefunden wurden, bleibt das Array unverändert. Ist das Array nicht vorhanden und gibt ADBOBJECTS( ) den Wert 0 zurück, wird das Array nicht erstellt.

  Wenn Sie CONNECTION, TABLE oder VIEW für cSetting angeben, wird ein eindimensionales Array erstellt. Jede Zeile dieses eindimensionalen Arrays enthält den Namen einer Verbindung, Tabelle oder Ansicht der Datenbank.

  Wenn Sie RELATION für cSetting angeben, wird ein zweidimensionales Array erstellt. Jede Zeile dieses zweidimensionalen Arrays entspricht einer Beziehung der Datenbank. Die erste Spalte einer Arrayzeile enthält den Namen der Detailtabelle und die zweite Spalte den Namen der Master-Tabelle. Die dritte Spalte enthält den Indexnamen der Detailtabelle und die vierte Spalte den Indexnamen der Master-Tabelle.

  Die fünfte Spalte einer Arrayzeile enthält Informationen zur referenziellen Integrität. Wenn eine Beziehung keine Regeln zur referenziellen Integrität besitzt, bleibt diese Spalte leer. Weist die Beziehung solche Regeln auf, enthält die Spalte Zeichen, die dem Typ der Regeln zur referenziellen Integrität für Aktualisierungen, Lösch- und Einfügevorgänge entsprechen.

  Das erste Zeichen gibt den Typ der Aktualisierungsregel an, das zweite Zeichen den Typ der Regel für Löschvorgänge und das dritte Zeichen den Typ der Regel für Einfügevorgänge.

  Mögliche Werte für Aktualisierungen und Löschvorgänge sind C (Cascade = Weitergeben), R (Restrict = Einschränken) und I (Ignorieren). Für Einfügevorgänge sind die Werte R und I möglich. Wenn eine Beziehung z. B. Aktualisierungsweitergaben und eingeschränkte Löschvorgänge erlaubt und die Regeln der referenziellen Integrität für Einfügevorgänge ignoriert, enthält die Spalte CRI.

• cSetting
  Gibt die in das Array einzufügenden Namen an. In der folgenden Tabelle sind die Werte für cSetting sowie die zugehörigen Namen im Array aufgelistet:

  cSetting	Namen
  CONNECTION	Verbindungsnamen
  RELATION	Tabellenbeziehungen
  TABLE	Tabellennamen
  VIEW	Ansichtennamen

  Für die CONNECTION-, RELATION-, TABLE- und VIEW-Einstellungen können Sie keine Abkürzungen verwenden.

Hinweise

Bei Ausgabe von ADBOBJECTS( ) muss eine Datenbank geöffnet sein und als aktuell erkannt werden; ansonsten generiert Visual FoxPro eine Fehlermeldung.

Beispiel

Im folgenden Beispiel wird die Datenbank testdata geöffnet; anschließend wird ADBOBJECTS( ) zum Erstellen eines Arrays mit Namen gaTables verwendet, das die Namen aller Tabellen in der Datenbank enthält. Danach werden die Tabellennamen angezeigt.

* Close any open databases
CLOSE DATABASES

* Clear desktop to prepare for displaying the array
CLEAR

* Open sample testdata database
OPEN DATABASE (HOME(2) + 'Data\testdata')

* Function call with cSetting for table names
=ADBOBJECTS(gaTables, "TABLE")

* Displays array gaTables created by ADBOBJECTS( ) function
DISPLAY MEMORY LIKE gaTables

Siehe auch

ADATABASES( ) | CREATE | CREATE CONNECTION | CREATE DATABASE | CREATE SQL VIEW | CREATE TABLE - SQL | DISPLAY DATABASE | INDBC( ) | LIST DATABASE | MODIFY DATABASE | SET DATABASE