| Pakiet | flash.errors |
| Klasa | public class SQLError |
| Dziedziczenie | SQLError  Error Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
W asynchronicznym trybie wykonywania wystąpienie błędu podczas operacji na bazie danych SQL powoduje wywołanie obiektu SQLErrorEvent przez instancję klasy SQLConnection lub SQLStatement. Informacje o błędzie w postaci instancji klasy SQLError są dostępne za pośrednictwem właściwości error obiektu SQLErrorEvent.
W synchronicznym trybie wykonywania wystąpienie błędu podczas operacji na bazie danych SQL powoduje wygenerowanie wyjątku SQLError przez instancję klasy SQLConnection lub SQLStatement. Wyjątek taki można obsłużyć, umieszczając instrukcje potencjalnie generujące błędy w bloku try..catch.
Ta klasa udostępnia właściwości zawierające szczegóły błędu (określające konkretny typ błędu, jaki wystąpił), komunikat tekstowy zawierający szczegóły błędu i operację, która spowodowała wystąpienie błędu.
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| detailArguments : Array [tylko do odczytu]
Tablica wartości String, która może być używana w celu konstruowania szczegółowego komunikatu o błędzie dotyczącym ustawień regionalnych. | SQLError | ||
| detailID : int [tylko do odczytu]
Numer referencyjny skojarzony z konkretnym komunikatem o błędzie. | SQLError | ||
| details : String [tylko do odczytu]
Szczegóły bieżącego błędu. | SQLError | ||
| errorID : int [tylko do odczytu]
Zawiera numer odwołania skojarzony z konkretnym komunikatem o błędzie. | Error | |
| message : String
Zawiera komunikat skojarzony z obiektem Error. | Error | |
| name : String
Zawiera nazwę obiektu Error. | Error | |
| operation : String [tylko do odczytu]
Wartość wskazująca na operację, którą próbowano wykonać, gdy wystąpił błąd. | SQLError | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)
Tworzy instancję klasy SQLError, którą można wygenerować jako wyjątek lub której można użyć we właściwości error instancji klasy SQLErrorEvent. | SQLError | ||
|
Zwraca ciąg reprezentujący stos wywołań związanych z błędem, który istniał w momencie uruchomienia konstruktora błędu. | Error | |
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
Domyślnie zwraca ciąg znaków „Error” lub wartość określoną przez właściwość Error.message (jeśli określona). | SQLError | ||
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
detailArguments | właściwość |
detailArguments:Array [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.1 |
Tablica wartości String, która może być używana w celu konstruowania szczegółowego komunikatu o błędzie dotyczącym ustawień regionalnych.
Ta właściwość zawiera wartość lub wartości, które zastępują komunikat o błędzie właściwości details w celu wskazania określonego obiektu lub obiektów bazy danych (nazwa tabeli, nazwa kolumny itp.) skojarzonego z błędem. Przykład: załóżmy, że aplikacji wystąpił błąd z następującym komunikatem o błędzie dotyczącym właściwości details:
there is already another table or index with this name: 'my_table'
W takim przypadku właściwość detailArguments instancji SQLError będzie zawierała pojedynczy element o wartości „my_table”.
Za pomocą właściwości detailID aplikacja może identyfikować określony komunikat o błędzie details. Aplikacja może wygenerować tekst alternatywny dla użytkownika końcowego w języku zgodnym z jego ustawieniami regionalnymi. Wartości argumentów w tablicy detailArguments mogą być zastępowane w określonej pozycji w ciągu znaków komunikatu o błędzie. Jest to użyteczne w przypadku aplikacji, które chcą wyświetlać komunikat o błędzie właściwości details bezpośrednio dla użytkowników końcowych o określonych ustawieniach regionalnych.
Listę wartości detailID oraz odpowiadających im argumentów i szczegółowych komunikatów o błędach w języku angielskim zawiera dokument Szczegółowe komunikaty o błędach, identyfikatory i argumenty SQL.
Implementacja
public function get detailArguments():Array detailID | właściwość |
detailID:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.1 |
Numer referencyjny skojarzony z konkretnym komunikatem o błędzie. Ta wartość jest używana do obsługiwania translacji określonych dla ustawień regionalnych w odniesieniu do komunikatu o błędzie właściwości details.
Ta właściwość udostępnia unikalny identyfikator dla każdego komunikatu details. (Dla każdego typu błędów o określonym identyfikatorze errorID istnieje wiele błędów z unikalnymi wartościami detailID). Korzystając z tego identyfikatora wraz z wartością lub wartościami z tablicy detailArguments. aplikacja może udostępniać komunikaty o błędach dotyczących ustawień regionalnych. Jest to użyteczne w przypadku aplikacji, które chcą wyświetlać komunikat o błędzie właściwości details bezpośrednio dla użytkowników końcowych o określonych ustawieniach regionalnych.
Listę wartości detailID oraz odpowiadających im argumentów i szczegółowych komunikatów o błędach w języku angielskim zawiera dokument Szczegółowe komunikaty o błędach, identyfikatory i argumenty SQL.
Implementacja
public function get detailID():int details | właściwość |
operation | właściwość |
operation:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Wartość wskazująca na operację, którą próbowano wykonać, gdy wystąpił błąd. Ta wartość jest jedną ze stałych zdefiniowanych w klasie SQLErrorOperation.
Implementacja
public function get operation():StringPowiązane elementy interfejsu API
SQLError | () | Konstruktor |
public function SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Tworzy instancję klasy SQLError, którą można wygenerować jako wyjątek lub której można użyć we właściwości error instancji klasy SQLErrorEvent.
operation:String — Wskazuje konkretną operację, która spowodowała niepowodzenie. Wartość jest jedną ze stałych zdefiniowanych w klasie SQLErrorOperation.
| |
details:String (default = " | |
message:String (default = " | |
id:int (default = 0) | |
detailID:int (default = -1) | |
detailArgs:Array (default = null) |
Powiązane elementy interfejsu API
toString | () | metoda |
Tue Jun 12 2018, 12:06 PM Z