Создает массив переменных памяти, содержащий информацию о самой последней ошибке, связанной с Visual FoxPro, OLE или ODBC.
Синтаксис:
AERROR(ArrayName)
Параметры:
ArrayName
Задает имя для массива, создаваемого функцией AERROR().
Результат:
Числовой
Комментарии:
Функция AERROR() создает массив из шести столбцов и некоторого числа строк. Тип ошибки определяет количество строк в массиве.
В приведенной ниже таблице описывается содержимое каждого элемента, формируемое в случае ошибки Visual FoxPro. В случае ошибки Visual FoxPro массив состоит из одной строки.
Номер элемента Описание 1 Числовой. Номер ошибки. Идентичен значению, возвращаемому функцией ERROR( ). 2 Символьный. Текст сообщения об ошибке. Идентичен значению, возвращаемому функцией MESSAGE( ). 3 Значение NULL. Однако если у ошибки есть дополнительный параметр, данный элемент содержит текст этого параметра ошибки. Идентичен значению, возвращаемому функцией SYS(2018). 4 Значение NULL. Однако в соответствующих случаях содержит номер рабочей области, в которой произошла ошибка. 5 Значение NULL. Однако при ошибке триггера (ошибка 1539) содержит одно из следующих числовых значений: 1 - Ошибка триггера добавления.2 - Ошибка триггера обновления.3 - Ошибка триггера удаления. 6 Значение NULL 7 Значение NULL
В следующей таблице описывается содержимое каждого элемента, формируемое в случае ошибки OLE с номером 1427 или 1429. В случае ошибки OLE массив состоит из одной строки.
Номер элемента Описание 1 Числовой. Содержит 1427 или 1429. 2 Символьный. Текст сообщения об ошибке Visual FoxPro. 3 Символьный. Текст сообщения об ошибке OLE. 4 Символьный. Имя приложения, например Microsoft Excel. 5 Значение NULL либо Символьный. Содержит имя того файла справки, в котором можно найти подробную информацию об ошибке, если приложение может его предоставить; в противном случае содержит значение NULL. 6 Значение NULL либо Символьный. Содержит ID контекста справки для соответствующей темы, если приложение может предоставить информацию; в противном случае содержит значение NULL. 7 Числовой. Ошибка OLE 2.0.
В следующей таблице описывается содержимое каждого элемента массива, формируемое в случае ошибки ODBC с номером 1526. В случае ошибки ODBC массив состоит из двух или более строк по одной строке на каждую ошибку ODBC.
Номер элемента Описание 1 Числовой. Содержит число 1526. 2 Символьный. Текст сообщения об ошибке. 3 Символьный. Текст сообщения об ошибке ODBC. 4 Символьный. Текущее состояние ODBC SQL. 5 Числовой. Номер ошибки от источника данных ODBC. 6 Числовой. Дескриптор связи ODBC 7 Значение NULL
Пример
* В следующем примере команда ON ERROR используется для задания * программы обработки ошибок errhand. Ошибка генерируется выдачей * неправильно набранной команды (BRWS). Программа errhand с помощью * функции AERROR( ) создает массив, содержащий информацию об ошибке, * а затем эта информация выводится на экран. 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