| Pacote | flash.errors |
| Classe | public class SQLError |
| Herança | SQLError  Error Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
No modo de execução assíncrono, quando ocorre um erro com uma operação de banco de dados SQL, a instância SQLConnection ou a SQLStatement despacha um objeto SQLErrorEvent. Informações sobre o erro na forma de uma ocorrência SQLError podem ser acessadas na propriedade error do objeto SQLErrorEvent.
No modo de execução assíncrona, quando ocorre um erro com uma operação de banco de dados SQL, a ocorrência SQLConnection ou a SQLStatement lança uma exceção SQLError, que pode ser tratada delimitando o código de erro lançada em um bloco try..catch.
Esta classe apresenta propriedades que contêm os detalhes do erro (indicando o tipo específico de erro ocorrido), uma mensagem de texto que contém os detalhes do erro e a operação que causou a ocorrência do erro.
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| detailArguments : Array [somente leitura]
Uma matriz de valores de string que pode ser usada para construir uma mensagem de erro detalhada e específica de local. | SQLError | ||
| detailID : int [somente leitura]
Um número de referência associado à mensagem detalhada e específica. | SQLError | ||
| details : String [somente leitura]
Detalhes do erro atual. | SQLError | ||
| errorID : int [somente leitura]
Contém o número de referência associado à mensagem de erro específica. | Error | |
| message : String
Contém a mensagem associada ao objeto Error. | Error | |
| name : String
Contém o nome do objeto Error. | Error | |
| operation : String [somente leitura]
Um valor indicando que estava ocorrendo tentativa da operação quando o erro ocorreu. | SQLError | ||
| Método | Definido por | ||
|---|---|---|---|
SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)
Cria uma ocorrência SQLError que pode ser lançada ou usada com uma propriedade error da ocorrência SQLErrorEvent. | SQLError | ||
|
Retorna a pilha de chamada para um erro no momento da construção do erro como sequência de caracteres. | Error | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
Retorna a string "Erro" por padrão ou o valor contido na propriedade Error.message, se definida. | SQLError | ||
|
Retorna o valor primitivo do objeto especificado. | Object | |
detailArguments | propriedade |
detailArguments:Array [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.1 |
Uma matriz de valores de string que pode ser usada para construir uma mensagem de erro detalhada e específica de local.
Essa propriedade contém o valor ou os valores que são substituídos na mensagem de erro de propriedade details para indicar o objeto ou os objetos específicos do banco de dados (nome de tabela, nome de coluna, e assim por diante) associados ao erro. Por exemplo, vamos supor que ocorra um erro com a seguinte mensagem de erro de propriedade details em um aplicativo:
there is already another table or index with this name: 'my_table'
Nesse caso, a propriedade detailArguments da ocorrência de SQLError conteria um único elemento com o valor "my_table".
Com a propriedade detailID um aplicativo pode identificar a mensagem de erro de details específica. O aplicativo pode fornecer texto alternativo para o usuário final no idioma do local. Os valores de argumento da matriz detailArguments podem ser substituídos na posição apropriada da string da mensagem de erro. Isso é útil para aplicativos que precisam exibir a mensagem de erro de propriedade details relativa a esse erro diretamente para os usuários finais em um local específico.
Para obter uma lista de valores detailID e os argumentos e a correspondente mensagem de detalhes de erro, consulte o apêndice "ID, argumentos e mensagens detalhadas de erro SQL".
Implementação
public function get detailArguments():Array detailID | propriedade |
detailID:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.1 |
Um número de referência associado à mensagem detalhada e específica. Esse valor é usado para suportar translações específicas de local da mensagem de erro de propriedade details.
Essa propriedade fornece um identificador exclusivo para cada mensagem de details. (Para qualquer tipo de erro com errorID específico, há vários erros com valores exclusivos de detailID.) Com esse identificador e o valor ou valores da matriz detailArguments, um aplicativo pode fornecer mensagens de erro detalhadas específicas de local. Isso é útil para aplicativos que precisam exibir a mensagem de erro de propriedade details relativa a esse erro diretamente para os usuários finais em um local específico.
Para obter uma lista de valores detailID e os argumentos e a correspondente mensagem de detalhes de erro, consulte o apêndice "ID, argumentos e mensagens detalhadas de erro SQL".
Implementação
public function get detailID():int details | propriedade |
operation | propriedade |
operation:String [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Um valor indicando que estava ocorrendo tentativa da operação quando o erro ocorreu. Esse valor é uma das constantes definidas na classe SQLErrorOperation.
Implementação
public function get operation():StringElementos da API relacionados
SQLError | () | Construtor |
public function SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Cria uma ocorrência SQLError que pode ser lançada ou usada com uma propriedade error da ocorrência SQLErrorEvent.
operation:String — Indica a operação específica que causou a falha. O valor é uma das constantes definidas na classe SQLErrorOperation.
| |
details:String (default = " | |
message:String (default = " | |
id:int (default = 0) | |
detailID:int (default = -1) | |
detailArgs:Array (default = null) |
Elementos da API relacionados
toString | () | método |
Wed Jun 13 2018, 11:10 AM Z