| Paket | flash.errors |
| Klasse | public class SQLError |
| Vererbung | SQLError  Error Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Im asynchronen Ausführungsmodus löst die SQLConnection- oder SQLStatement-Instanz ein SQLErrorEvent-Objekt aus, wenn bei einem SQL-Datenbankvorgang ein Fehler auftritt. Informationen zu dem Fehler lassen sich in Form einer SQLError-Instanz von der error-Eigenschaft des SQLErrorEvent-Objekts aufrufen.
Wenn im synchronen Ausführungsmodus ein Fehler bei einem SQL-Datenbankvorgang auftritt, gibt die SQLConnection- oder SQLStatement-Instanz eine SQLError-Ausnahme aus, die sich durch Einschließen des Fehler verursachenden Codes in einen try..catch-Block verarbeiten lässt.
Diese Klasse stellt Eigenschaften bereit, die Details zum Fehler (unter Angabe des spezifischen Fehlertyps), eine Textmeldung mit Details zum Fehler sowie den Vorgang, der den Fehler verursacht hat, enthalten.
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| detailArguments : Array [schreibgeschützt]
Ein Array von Stringwerten, das für die Erstellung einer gebietsschemaspezifischen Fehlermeldung verwendet wird. | SQLError | ||
| detailID : int [schreibgeschützt]
Die Referenznummer der spezifischen Fehlerdetailmeldung. | SQLError | ||
| details : String [schreibgeschützt]
Details zum aktuellen Fehler. | SQLError | ||
| errorID : int [schreibgeschützt]
Enthält die Verweisnummer der zugeordneten Fehlermeldung. | Error | |
| message : String
Enthält die mit dem Error-Objekt verbundene Meldung. | Error | |
| name : String
Enthält den Namen des Error-Objekts. | Error | |
| operation : String [schreibgeschützt]
Ein Wert, der den Vorgang angibt, der beim Auftreten des Fehlers ausgeführt werden sollte. | SQLError | ||
| Methode | Definiert von | ||
|---|---|---|---|
SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)
Erstellt eine SQLError-Instanz, die ausgegeben oder mit der error-Eigenschaft einer SQLErrorEvent-Instanz verwendet werden kann. | SQLError | ||
|
Gibt den Aufrufstapel für einen Fehler zum Zeitpunkt der Fehlerentstehung als String zurück. | Error | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
Gibt in der Standardeinstellung den String „Error“ oder, sofern definiert, den in der Error.message-Eigenschaft enthaltenen Wert zurück. | SQLError | ||
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
detailArguments | Eigenschaft |
detailArguments:Array [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.1 |
Ein Array von Stringwerten, das für die Erstellung einer gebietsschemaspezifischen Fehlermeldung verwendet wird.
Diese Eigenschaft enthält einen oder mehrere Werte, die in der details-Eigenschaft der Fehlermeldung ersetzt werden und die mit dem Fehler verknüpften spezifischen Datenbankobjekte (Tabellenname, Spaltenname usw.) angeben. Beispiel: In einer Anwendung tritt ein Fehler mit der folgenden details-Eigenschaft der Fehlermeldung auf:
there is already another table or index with this name: 'my_table'
In diesem Fall enthält die detailArguments-Eigenschaft der SQLError-Instanz ein einzelnes Element mit dem Wert "my_table".
Mithilfe der detailID-Eigenschaft kann eine Anwendung die jeweilige details-Fehlermeldung identifizieren. Die Anwendung kann dem Endbenutzer einen Alternativtext in der Sprache des betreffenden Gebietsschemas bereitstellen. Die Argumentwerte im detailArguments-Array können an der passenden Position im Fehlernachrichtenstring ersetzt werden. Das ist hilfreich bei Anwendungen, bei denen Benutzern in einem bestimmten Gebietsschema der Inhalt der details-Eigenschaft der Fehlermeldung für diesen Fehler direkt angezeigt werden soll.
Eine Liste der detailID-Werte und der dazugehörigen deutschen Fehlerinformationsmeldungen und -argumente finden Sie unter „SQL Fehlerdetailmeldungen, IDs und Argumente“.
Implementierung
public function get detailArguments():Array detailID | Eigenschaft |
detailID:int [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.1 |
Die Referenznummer der spezifischen Fehlerdetailmeldung. Dieser Wert unterstützt gebietsschemaspezifische Übersetzungen der details-Eigenschaft der Fehlermeldung.
Diese Eigenschaft stellt einen eindeutigen Bezeichner für jede details-Nachricht bereit. (Für jeden Fehlertyp mit einer bestimmten errorID gibt es mehrere Fehler mit eindeutigen detailID-Werten.) Wird dieser Bezeichner gemeinsam mit Werten im detailArguments-Array verwendet, so kann eine Anwendung gebietsschemaspezifische Fehlernachrichten bereitstellen. Das ist hilfreich bei Anwendungen, bei denen Benutzern in einem bestimmten Gebietsschema der Inhalt der details-Eigenschaft der Fehlermeldung für diesen Fehler direkt angezeigt werden soll.
Eine Liste der detailID-Werte und der dazugehörigen deutschen Fehlerinformationsmeldungen und -argumente finden Sie unter „SQL Fehlerdetailmeldungen, IDs und Argumente“.
Implementierung
public function get detailID():int details | Eigenschaft |
operation | Eigenschaft |
operation:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Ein Wert, der den Vorgang angibt, der beim Auftreten des Fehlers ausgeführt werden sollte. Dieser Wert ist eine der Konstanten, die in der SQLErrorOperation-Klasse definiert sind.
Implementierung
public function get operation():StringVerwandte API-Elemente
SQLError | () | Konstruktor |
public function SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Erstellt eine SQLError-Instanz, die ausgegeben oder mit der error-Eigenschaft einer SQLErrorEvent-Instanz verwendet werden kann.
operation:String — Gibt den spezifischen Vorgang an, der den Fehler verursacht hat. Der Wert ist eine der Konstanten, die in der SQLErrorOperation-Klasse definiert sind.
| |
details:String (default = " | |
message:String (default = " | |
id:int (default = 0) | |
detailID:int (default = -1) | |
detailArgs:Array (default = null) |
Verwandte API-Elemente
toString | () | Methode |
Tue Jun 12 2018, 10:04 AM Z