Freigeben über

AERROR( )-Funktion

  • Artikel

Erstellt ein Array, das Informationen über den letzten Visual FoxPro-, OLE- oder ODBC-Fehler enthält.

AERROR(ArrayName)

Rückgabewerte

Numerisch

Parameter

  • ArrayName
    Gibt den Namen des von AERROR( ) zu erstellenden Arrays an.

Hinweise

AERROR( ) erstellt ein Array mit sechs Spalten und gibt die Anzahl der Zeilen im Array zurück. Die Art des aufgetretenen Fehlers bestimmt die Anzahl der Zeilen im Array.

Die folgende Tabelle beschreibt den Inhalt jedes Elements, wenn ein Visual FoxPro-Fehler auftritt. Bei Auftreten eines Visual FoxPro-Fehlers enthält das Array eine Zeile.

Elementnummer Beschreibung
1 Numerisch. Die Nummer des Fehlers. Identisch mit dem von ERROR( ) zurückgegebenen Wert.
2 Zeichen. Der Text der Fehlermeldung. Identisch mit dem von MESSAGE( ) zurückgegebenen Wert.
3 Der Nullwert. Enthält jedoch den Text des Fehlerparameters, wenn der Fehler über einen zusätzlichen Fehlerparameter verfügt. Identisch mit dem von SYS(2018) zurückgegebenen Wert.
4 Der Nullwert. Enthält gegebenenfalls die Nummer des Arbeitsbereichs, in dem der Fehler aufgetreten ist.
5 Der Nullwert. Wenn ein Trigger-Befehl fehlgeschlagen ist (Fehler 1539), enthält dieser einen der folgenden numerischen Werte:
1 – Insert-Trigger fehlgeschlagen. 2 – Update-Trigger fehlgeschlagen. 3 – Delete-Trigger fehlgeschlagen.
6 Der Nullwert.
7 Der Nullwert.

Die folgende Tabelle beschreibt den Inhalt jedes Elements, wenn die OLE-Fehler Nummer 1427 oder 1429 aufgetreten sind. Bei Auftreten dieser OLE-Fehler enthält das Array eine Zeile.

Elementnummer Beschreibung
1 Numerisch. Enthält den Wert 1427 oder 1429.
2 Zeichen. Enthält den Text der Visual FoxPro-Fehlermeldung.
3 Zeichen. Enthält den Text der OLE-Fehlermeldung.
4 Zeichen. Enthält den Anwendungsnamen (z. B. Microsoft Excel).
5 Nullwert oder Zeichen. Enthält den Namen der Hilfedatei der Anwendung, in der weitere Informationen über den Fehler gefunden werden können, wenn seitens der Anwendung Informationen zur Verfügung stehen, andernfalls den Nullwert.
6 Nullwert oder Zeichen. Enthält die Hilfekontext-ID des entsprechenden Hilfethemas, wenn seitens der Anwendung Informationen zur Verfügung stehen, andernfalls den Nullwert.
7 Numerisch. Eine OLE 2.0-Ausnahmenummer.

Die folgende Tabelle beschreibt den Inhalt jedes Elements, wenn ODBC-Fehler Nr. 1526 aufgetreten ist. Wenn ein ODBC-Fehler auftritt, enthält das Array zwei oder mehr Zeilen, und zwar eine Zeile für jeden ODBC-Fehler.

Elementnummer Beschreibung
1 Numerisch. Enthält 1526.
2 Zeichen. Der Text der Fehlermeldung.
3 Zeichen. Enthält den Text der ODBC-Fehlermeldung.
4 Zeichen. Enthält den aktuellen ODBC-SQL-Status.
5 Numerisch. Enthält die Fehlernummer aus der ODBC-Datenquelle.
6 Numerisch. Enthält das ODBC-Verbindungshandle.
7 Der Nullwert.

Beispiel

Im folgenden Beispiel wird ON ERROR verwendet, um eine Fehlerbehandlungsroutine mit Namen errhand festzulegen. Durch Ausgabe eines falsch geschriebenen Befehls (BRWS) wird ein Fehler generiert. Die Fehlerbehandlungsroutine errhand verwendet AERROR( ), um ein Array zu erstellen, das Fehlerinformationen enthält. Diese Information wird anschließend angezeigt.

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

Siehe auch

COMRETURNERROR( ) | CREATE TRIGGER | ERROR-Befehl | ERROR( )-Funktion | MESSAGE( ) | ON ERROR | SYS(2018) - Fehlermeldungsparameter