| Paquete | flash.errors |
| Clase | public class SQLError |
| Herencia | SQLError  Error Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
En modo de ejecución asíncrona, cuando se produce un error en el funcionamiento de una base de datos SQL, la instancia SQLConnection o SQLStatement distribuye un objeto SQLErrorEvent. Se puede acceder a la información relativa al error en el formulario de una instancia SQLError desde la propiedad error del objeto SQLErrorEvent.
En modo de ejecución sincrónica, cuando se produce un error en el funcionamiento de una base de datos SQL, la instancia SQLConnection o SQLStatement emite una excepción SQLError. Ésta puede controlarse encerrando el código de emisión del error en un bloque try..catch.
Esta clase proporciona las propiedades que contienen los detalles del error (y el tipo concreto de error que se ha producido), un mensaje de texto con la información detallada y la operación que pudo provocar el error.
Elementos de API relacionados
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| detailArguments : Array [solo lectura]
Un conjunto de valores String que se puede utilizar para construir un mensaje de error detallado de configuración regional. | SQLError | ||
| detailID : int [solo lectura]
Número de referencia asociado al mensaje de error detallado. | SQLError | ||
| details : String [solo lectura]
Detalles del error actual. | SQLError | ||
| errorID : int [solo lectura]
Contiene el número de referencia asociado al mensaje de error concreto. | Error | |
| message : String
Contiene el mensaje asociado al objeto Error. | Error | |
| name : String
Contiene el nombre del objeto Error. | Error | |
| operation : String [solo lectura]
Valor que indica la operación que se estaba intentando realizar cuando se produjo el error. | SQLError | ||
| Método | Definido por | ||
|---|---|---|---|
SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)
Crea una instancia SQLError que se puede emitir o utilizar con una propiedad error de la instancia SQLErrorEvent. | SQLError | ||
|
Devuelve la pila de llamadas de un error en el momento de la construcción del error como una cadena. | Error | |
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
Devuelve la cadena "Error" de manera predeterminada o el valor contenido en la propiedad Error.message, en el caso de que se haya definido. | SQLError | ||
|
Devuelve el valor simple del objeto especificado. | Object | |
detailArguments | propiedad |
detailArguments:Array [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.1 |
Un conjunto de valores String que se puede utilizar para construir un mensaje de error detallado de configuración regional.
Esta propiedad contiene el valor o los valores que se sustituyen en el mensaje de error de la propiedad details para indicar el objeto o los objetos concretos (nombre de tabla, nombre de columna, etc.) asociados al error. Por ejemplo, supongamos que se produce un error con el siguiente mensaje de error de la propiedad details en una aplicación:
there is already another table or index with this name: 'my_table'
En este caso, la propiedad detailArguments de la instancia de SQLError debería contener un solo elemento con el valor "my_table".
Si se utiliza la propiedad detailID, una aplicación puede identificar el mensaje de error de details específico. La aplicación puede proporcionar texto alternativo al usuario final en el idioma de su configuración regional. Los valores de los argumentos del conjunto detailArguments se pueden sustituir en la posición adecuada de la cadena del mensaje de error. Esto resulta útil en aplicaciones que quieran mostrar el mensaje de error de la propiedad details para este error directamente a los usuarios finales en una configuración regional concreta.
Para obtener una lista con los valores de detailID y sus mensajes de error en inglés y argumentos correspondientes, consulte “Mensajes detallados de error SQL, identificadores y argumentos”.
Implementación
public function get detailArguments():Array detailID | propiedad |
detailID:int [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.1 |
Número de referencia asociado al mensaje de error detallado. Este valor se utiliza para admitir conversiones específicas de configuración regional en el mensaje de error de la propiedad details.
Esta propiedad proporciona un identificador unívoco para cada mensaje details. (Para cualquier tipo de error con un errorID concreto existen varios errores con valores detailID unívocos.) Si se utiliza este identificador junto con el valor o los valores del conjunto detailArguments, una aplicación puede lanzar mensajes de error detallados específicos de configuración regional. Esto resulta útil en aplicaciones que quieran mostrar el mensaje de error de la propiedad details para este error directamente a los usuarios finales en una configuración regional concreta.
Para obtener una lista con los valores de detailID y sus mensajes de error en inglés y argumentos correspondientes, consulte “Mensajes detallados de error SQL, identificadores y argumentos”.
Implementación
public function get detailID():int details | propiedad |
operation | propiedad |
operation:String [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Valor que indica la operación que se estaba intentando realizar cuando se produjo el error. Este valor es una de las constantes definidas en la clase SQLErrorOperation.
Implementación
public function get operation():StringElementos de API relacionados
SQLError | () | Información sobre |
public function SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Crea una instancia SQLError que se puede emitir o utilizar con una propiedad error de la instancia SQLErrorEvent.
operation:String — Indica la operación concreta que provocó el error. El valor es una de las constantes definidas en la clase SQLErrorOperation.
| |
details:String (default = " | |
message:String (default = " | |
id:int (default = 0) | |
detailID:int (default = -1) | |
detailArgs:Array (default = null) |
Elementos de API relacionados
toString | () | método |
Tue Jun 12 2018, 02:12 PM Z