AERROR( ) (Función)

  • Artículo

Crea una matriz de variables con información relativa al error más reciente de Visual FoxPro, OLE u ODBC.

AERROR(ArrayName)

Valores devueltos

Numeric

Parámetros

  • ArrayName
    Especifica el nombre de la matriz que creará AERROR( ).

Observaciones

AERROR( ) crea una matriz con siete columnas y devuelve el número de filas de la matriz. El tipo de error que se produce determina el número de filas de la matriz.

La siguiente tabla describe el contenido de cada elemento cuando ocurre un error de Visual FoxPro. Cuando se produce un error de Visual FoxPro, la matriz contiene una fila.

Número de elemento Descripción
1 Numeric. El número del error. Es idéntico al valor devuelto por ERROR( ).
2 Character. El texto del mensaje de error. Es idéntico al valor devuelto por MESSAGE( ).
3 El valor Null. No obstante, si el error tiene un parámetro de error adicional, contiene el texto de dicho parámetro. Es idéntico al valor devuelto por SYS(2018).
4 El valor Null. No obstante, cuando corresponda, contiene el número del área de trabajo donde se produjo el error.
5 El valor Null. No obstante, si ha fallado un desencadenador (error 1539), contiene uno de los siguientes valores numéricos: 1 - Error del desencadenador Insert. 2 – Error del desencadenador Update. 3 – Error del desencadenador Delete.
6 El valor Null.
7 El valor Null.

La tabla siguiente describe el contenido de cada elemento cuando se producen los errores número 1427 o 1429. Cuando se producen estos errores OLE, la matriz contiene una fila.

Número de elemento Descripción
1 Numeric. Contiene 1427 ó 1429.
2 Character. El texto del mensaje de error de Visual FoxPro.
3 Character. El texto del mensaje de error de OLE.
4 Character. El nombre de la aplicación (por ejemplo, Microsoft Excel).
5 El valor nulo o carácter. Contiene el nombre del archivo de Ayuda de la aplicación, donde hay más información acerca del error; de lo contrario, contiene el valor nulo.
6 El valor nulo o carácter. Contiene el Id. de contexto de la Ayuda para el tema de Ayuda si hay información disponible en la aplicación; de lo contrario, devuelve el valor nulo.
7 Numeric. Un número de excepción de OLE 2.0.

La tabla siguiente describe el contenido de cada elemento cuando se produce un error ODBC número 1526. Cuando se produce un error ODBC, la matriz contiene dos o más filas, una por cada error ODBC.

Número de elemento Descripción
1 Numeric. Contiene 1526.
2 Character. El texto del mensaje de error.
3 Character. El texto del mensaje de error ODBC.
4 Character. El estado SQL de ODBC actual.
5 Numeric. El número de error desde el origen de datos ODBC.
6 Numeric. El controlador de conexión ODBC.
7 El valor Null.

Ejemplo

El ejemplo siguiente utiliza ON ERROR para especificar una rutina de tratamiento de errores denominada errhand. Se genera un error al ejecutar un comando mal escrito (BRWS). La rutina errhand utiliza AERROR( ) para crear una matriz que contiene información de error y se muestra esta información.

ON ERROR DO errhand     && errhand is the error handler procedure

BRWS  && Causes a syntax error
ON ERROR  && Restore system error handler

PROCEDURE errhand
   = AERROR(aErrorArray)  && Data from most recent error
   CLEAR
   ? 'The error provided the following information'  && Display message
   FOR n = 1 TO 7  && Display all elements of the array
      ? aErrorArray(n)
   ENDFOR

Vea también

COMRETURNERROR( ) | CREATE TRIGGER | ERROR | ERROR( ) | MESSAGE( ) | ON ERROR | SYS(2018) – Parámetro de mensaje de error