ADBOBJECTS( ) (Función)

  • Artículo

Sitúa los nombres de conexiones con nombre, relaciones, tablas o vistas SQL de la base de datos actual en una matriz.

ADBOBJECTS(ArrayName, cSetting)

Valores devueltos

Numeric

Parámetros

  • ArrayName
    Especifica el nombre de la matriz en que se sitúan los nombres. Si la matriz que especifica no existe, Visual FoxPro la creará automáticamente. Si existe y no es suficientemente grande para dar cabida a todos los nombres, Visual FoxPro aumentará automáticamente el tamaño. Si la matriz es mayor de lo necesario, Visual FoxPro reducirá su tamaño. Si existe y ADBOBJECTS( ) devuelve 0 porque no encuentra ningún nombre, permanecerá sin cambios. Si la matriz no existe y ADBOBJECTS( ) devuelve 0, la matriz no se creará.

    Cuando especifique CONNECTION, TABLE o VIEW para cSetting, se crea una matriz unidimensional. Cada fila de la matriz unidimensional contiene el nombre de una conexión, tabla o vista de la base de datos.

    Cuando se especifica RELATION para cSetting, se crea una matriz bidimensional. Cada fila de la matriz bidimensional corresponde a una relación de la base de datos. La primera columna de una fila de matriz contiene el nombre de la tabla secundaria, y la columna secundaria de una fila de matriz contiene el nombre de la tabla principal. La tercera columna contiene el nombre de la etiqueta del índice para la tabla secundaria, y la cuarta columna contiene el nombre de la etiqueta del índice para la tabla principal.

    La quinta columna de una fila de matriz contiene información de integridad referencial. Esta columna está vacía si la relación no tiene reglas de integridad referencial. Si la relación tiene reglas de integridad referencial, la columna contiene caracteres que corresponden al tipo de reglas de integridad referencial para actualizaciones, eliminaciones e inserciones.

    El primer carácter indica el tipo de regla de actualización, el segundo carácter indica el tipo de regla de eliminación y el tercero indica el tipo de regla de inserción.

    Los posibles valores para actualizaciones y eliminaciones son “C” para cascada, “R” para restringir e “I” para pasar por alto. Los valores posibles para inserciones son “R” para restringir e “I” para pasar por alto. Por ejemplo, si una relación tiene actualizaciones en cascada, eliminaciones restringidas y pasa por alto las reglas de integridad referencial de inserción, la columna contendrá “CRI”.

  • cSetting
    Especifica los nombres que se sitúan en una matriz de variables. La tabla siguiente indica los valores para cSetting y los nombres correspondientes situados en la matriz:

    cSetting Nombres
    CONNECTION Nombres de conexión
    RELATION Relaciones de tabla
    TABLE Nombres de tabla
    VIEW Nombres de vista

    La configuración de CONNECTION, RELATION, TABLE y VIEW no se puede abreviar.

Observaciones

Cuando se ejecuta ADBOBJECTS( ), debe haber una base de datos abierta y actual; de lo contrario, Visual FoxPro generará un mensaje de error.

Ejemplo

El ejemplo siguiente abre la base de datos testdata y utiliza ADBOBJECTS( ) para crear una matriz llamada gaTables que contiene los nombres de las tablas de la base de datos. Después se muestran los nombres de las tablas.

* 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

Vea también

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