Referência do ActionScript® 3.0 para Adobe® Flash® Platform
Início  |  Ocultar listas de Pacotes e Classes |  Pacotes  |  Classes  |  Novidades  |  Índice  |  Apêndices  |  Por que inglês?
Filtros: AIR 30.0 e anterior, Flash Player 30.0 e anterior, Flash Lite 4
Flex 4.6 e anterior, Flash Pro CS6 e anterior
Ocultar filtros
flash.data 

SQLStatement  - AS3

Pacotesx

Nível superior
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Elementos de linguagem

Constantes globais
Funções globais
Operadores
Instruções, palavras-chave e diretivas
Tipos especiais

Apêndices

Novidades
Erros do compilador
Avisos do compilador
Erros de runtime
Migrando para o ActionScript 3
Conjuntos de caracteres suportados
Tags MXML apenas
Elementos XML de movimento
Marcas de texto cronometradas
Lista de elementos deprecados
Constantes de Implementação de Acessibilidade
Como Usar Exemplos do ActionScript
Aspectos jurídicos
Pacoteflash.data
Classepublic class SQLStatement
HerançaSQLStatement Inheritance EventDispatcher Inheritance Object

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

Uma ocorrência SQLStatement é usada para executar uma instrução SQL contra um banco de dados SQL local que seja aberto por intermédio de uma ocorrência SQLConnection.

Uma instância SQLStatement é vinculada a uma instância SQLConnection definindo a instância SQLConnection como o valor da propriedade sqlConnection da instância SQLStatement. A propriedade text é preenchida com o texto real da instrução SQL a ser executada. Se necessário, os valores dos parâmetros da instrução SQL são especificados usando a propriedade parameters, e a instrução é executada chamando o método execute().

Para uma descrição completa do dialeto SQL suportado em bancos de dados SQL locais, consulte o apêndice Suporte SQL em bancos de dados locais.

No modo de execução assíncrono, os métodos execute() e next() são executados em segundo plano, e o tempo de execução despacha eventos para ouvintes de eventos registrados ou para uma ocorrência Responder especificada quando as operações são concluídas ou falham. No modo sincrônico, os métodos são executados na cadeia principal do aplicativo, o que significa que nenhum outro código é executado até que as operações do banco de dados estejam concluídas. Além disso, no modo sincrônico, se os métodos falham, o tempo de execução lança uma exceção em vez de despachar um evento de erro.

Elementos da API relacionados



Propriedades públicas
 PropriedadeDefinido por
 Inheritedconstructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.
Object
      executing : Boolean
[somente leitura] Indica se a instrução está sendo executada no momento.
SQLStatement
      itemClass : Class
Indica uma classe (tipo de dado) que é usada para cada linha retornada como um resultado da execução da instrução.
SQLStatement
      parameters : Object
[somente leitura] Serve como uma matriz associativa à qual você adiciona valores para os parâmetros especificados na propriedade text da instrução SQL.
SQLStatement
      sqlConnection : SQLConnection
O objeto SQLConnection que gerencia a conexão com o(s) banco(s) de dados no(s) qual(is) a instrução é executada.
SQLStatement
      text : String
O texto SQL real da instrução.
SQLStatement
Métodos públicos
 MétodoDefinido por
  
    SQLStatement()
Cria uma ocorrência SQLStatement.
SQLStatement
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento.
EventDispatcher
  
    cancel():void
Cancela a execução dessa instrução.
SQLStatement
  
Limpa todas as definições de parâmetros atuais.
SQLStatement
 Inherited
Envia um evento para o fluxo de eventos.
EventDispatcher
  
    execute(prefetch:int = -1, responder:Responder = null):void
Executa a SQL na propriedade de texto contra o banco de dados que está conectado ao objeto SQLConnection na propriedade sqlConnection.
SQLStatement
  
Provê acesso a um objeto SQLResult contendo os resultados da execução da instrução, incluindo qualquer linha de resultado de uma instrução SELECT e outras informações sobre a execução da instrução de todas as instruções executadas.
SQLStatement
 Inherited
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.
EventDispatcher
 Inherited
Indica se um objeto tem uma propriedade especificada definida.
Object
 Inherited
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.
Object
  
    next(prefetch:int = -1, responder:Responder = null):void
Recupera a próxima porção de um conjunto de resultados da instrução SELECT.
SQLStatement
 Inherited
Indica se a propriedade especificada existe e é enumerável.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Remove um ouvinte do objeto EventDispatcher.
EventDispatcher
 Inherited
Define a disponibilidade de uma propriedade dinâmica para operações de repetição.
Object
 Inherited
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.
Object
 Inherited
Retorna a representação de string do objeto especificado.
Object
 Inherited
Retorna o valor primitivo do objeto especificado.
Object
 Inherited
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado.
EventDispatcher
Eventos
 Evento Resumo Definido por
 Inherited[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo.EventDispatcher
 Inherited[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo.EventDispatcher
  
    error
Despachado quando ocorre um erro durante uma operação.SQLStatement
  
    result
Despachado quando uma operação de chamada dos métodos execute() ou next() é concluída com êxito.SQLStatement
Detalhes da propriedade
    

executing

propriedade
executing:Boolean  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

Indica se a instrução está sendo executada no momento.

Essa propriedade será true se execute() tiver sido chamado e se nem todos os resultados tiverem sido retornados do banco de dados.



Implementação
    public function get executing():Boolean

Elementos da API relacionados

    

itemClass

propriedade 
itemClass:Class

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

Indica uma classe (tipo de dado) que é usada para cada linha retornada como um resultado da execução da instrução.

Por padrão, cada linha retornada por uma instrução SELECT é criada como uma ocorrência Object, com os nomes das colunas do conjunto de resultados conforme os nomes das propriedades do objeto, e o valor de cada coluna conforme o valor de sua propriedade associada.

Ao especificar uma classe para a propriedade itemClass, cada linha retornada por uma instrução SELECT executada por essa ocorrência SQLStatement é criada como uma ocorrência da classe designada. Cada propriedade da ocorrência itemClass recebe o valor da coluna com o mesmo nome da propriedade.

Qualquer classe atribuída a essa propriedade deve ter um construtor que não requeira qualquer parâmetro. Além disso, a classe deve ter uma única propriedade para cada coluna retornada pela instrução SELECT. Será considerado um erro se uma coluna na lista SELECT não tiver um nome de propriedade correspondente na classe itemClass.



Implementação
    public function get itemClass():Class
    public function set itemClass(value:Class):void

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O código a seguir demonstra o uso da propriedade itemClass para fazer com que o tempo de execução crie ocorrências de uma classe personalizada a partir dos resultados da instrução SELECT.
// Employee class definition
package
{
    public class Employee
    {
        public var name:String;
        public var ssn:String;
        public var id:uint;
        public override function toString():String
        {
            return "id: "+ id.toString() + " name: " + name + " ssn: " + ssn;
        }
    }
}


// using the Employee class as SQLStatement.itemClass
var conn:SQLConnection;
var dbStatement:SQLStatement;

function init():void
{
    conn = new SQLConnection();
    conn.addEventListener(SQLEvent.OPEN, connOpenHandler);
    
    dbStatement = new SQLStatement();
    dbStatement.sqlConnection = conn;
    dbStatement.text = "SELECT id, name, ssn FROM employees";
    dbStatement.itemClass = Employee;
    
    var dbFile:File = new File(File.separator + "employee.db");
    conn.open(dbFile);
}

function connOpenHandler(event:SQLEvent):void
{
    dbStatement.addEventListener(SQLEvent.RESULT, resultHandler);
    dbStatement.execute();
}

function resultHandler(event:SQLEvent):void
{
    var result:SQLResult = dbStatement.getResult();
    if (result != null)
    {
        var emp:Employee;
        var numRows:int = result.data.length;
        for (var i:int = 0; i < numRows; i++)
        {
            emp = result.data[i];
            trace(emp.toString());
        }
    }
}
    

parameters

propriedade 
parameters:Object  [somente leitura]

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

Serve como uma matriz associativa à qual você adiciona valores para os parâmetros especificados na propriedade text da instrução SQL. As chaves da matriz são os nomes dos parâmetros. Se um parâmetro sem nome é especificado no texto da instrução, sua chave é o índice do parâmetro.

Dentro do texto de uma instrução SQL, um parâmetro é indicado com um dos seguintes caracteres: "?", ":" ou "@".

As fichas ":" e "@" indicam um parâmetro nomeado; os caracteres seguintes à ficha designam o nome do parâmetro.

Por exemplo, na seguinte instrução SQL, um parâmetro nomeado firstName é especificado usando o caractere ":":

SELECT FROM employees WHERE firstName = :firstName

A ficha "?" indica um parâmetro indexado (numerado); cada parâmetro recebe automaticamente um índice de acordo com a sequência dos parâmetros no texto da instrução. Os valores de índices de parâmetros são baseados em zero. Em outras palavras, o índice do primeiro parâmetro é 0.

Os parâmetros são usados para permitir a substituição digitada de valores que são desconhecidos no momento em que a instrução SQL é construída. O uso de parâmetros é o único modo de garantir a classe de armazenamento para um valor passado ao banco de dados. Quando os parâmetros não são usados, todos os valores são convertidos de sua representação de texto para uma classe de armazenamento baseada na afinidade do tipo da coluna associada. Para obter mais informações sobre classes de armazenamento e afinidade de colunas, consulte a seção "Suporte ao tipo de dados" no apêndice "Suporte SQL em bancos de dados locais".

Os parâmetros também são usados como medida de segurança para evitar um técnica mal-intencionada conhecida como ataque de injeção SQL. Em um ataque de injeção SQL, um usuário informa o código SQL em um local acessível ao usuário (por exemplo, um campo de entrada de dados). Se o código do aplicativo construir uma instrução SQL concatenando diretamente a entrada do usuário no texto SQL, o código SQL informado pelo usuário será executado em relação ao banco de dados. A lista a seguir mostra um exemplo de concatenação da entrada do usuário no texto SQL. Não use essa técnica:

     // assume the variables "username" and "password"
     // contain user-entered data
     var sql:String =
         "SELECT userId " +
         "FROM users " +
         "WHERE username = '" + username + "' " +
         "    AND password = '" + password + "'";
     var statement:SQLStatement = new SQLStatement();
     statement.text = sql;
     

O uso de parâmetros de instruções em vez da concatenação de valores informados pelo usuário no texto de uma instrução evita um ataque de injeção SQL, pois os valores de parâmetros são tratados explicitamente como valores substituídos, em vez de se tornarem parte do texto literal da instrução. A seguir, é dada a alternativa recomendada para a listagem anterior:

     // assume the variables "username" and "password"
     // contain user-entered data
     var sql:String =
         "SELECT userId " +
         "FROM users " +
         "WHERE username = :username " +
         "    AND password = :password";
     var statement:SQLStatement = new SQLStatement();
     statement.text = sql;
     // set parameter values
     statement.parameters[":username"] = username;
     statement.parameters[":password"] = password;
     

Todos os valores de parâmetros devem ser definidos antes da execução da instrução. Os valores de parâmetros especificados na matriz parameters são vinculados (ou seja, combinados com o texto da instrução) quando o método execute() é chamado. Uma vez que execute() tenha sido chamado, quaisquer alterações subsequentes nos valores não serão aplicadas à instrução em execução. No entanto, em uma chamada execute() subsequente, os valores alterados são usados. Se o texto da instrução incluir um parâmetro que não tenha um valor especificado na propriedade parameters, ocorrerá um erro.

Para limpar todos os valores de parâmetros da propriedade tempo de execução do Flash, use o método clearParameters().



Implementação
    public function get parameters():Object

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )
O exemplo a seguir mostra o uso de um parâmetro nomeado, :firstName, em uma instrução SQL.
// employees is a SQLStatement instance
employees.text = "SELECT FROM employees WHERE first = :firstName";
employees.parameters[":firstName"] = "Sam";
employees.execute();
O exemplo a seguir mostra o uso de um parâmetro sem nome em uma instrução SQL.
// employees is a SQLStatement instance
employees.text = "SELECT FROM employees WHERE first = ?";
employees.parameters[0] = "Sam";
employees.execute();
    

sqlConnection

propriedade 
sqlConnection:SQLConnection

Versões de runtime: AIR 1.0

O objeto SQLConnection que gerencia a conexão com o(s) banco(s) de dados no(s) qual(is) a instrução é executada.



Implementação
    public function get sqlConnection():SQLConnection
    public function set sqlConnection(value:SQLConnection):void

Lança
IllegalOperationError — Quando é feita uma tentativa para mudar o valor dessa propriedade enquanto a instrução está em execução.
    

text

propriedade 
text:String

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

O texto SQL real da instrução.

O texto pode ser qualquer SQL suportada. Para uma descrição completa do dialeto SQL suportado em bancos de dados SQL locais, consulte o apêndice "Suporte SQL em bancos de dados locais".



Implementação
    public function get text():String
    public function set text(value:String):void

Lança
IllegalOperationError — Quando é feita uma tentativa para mudar a propriedade text enquanto a instrução está em execução.
Detalhes do construtor
    

SQLStatement

()Construtor
public function SQLStatement()

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

Cria uma ocorrência SQLStatement.


Lança
SecurityError — Se o construtor for chamado a partir de qualquer caixa de proteção externa à caixa de proteção do aplicativo principal.
Detalhes do método

    cancel

()método
public function cancel():void

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

Cancela a execução dessa instrução. Assim como SQLConnection.cancel(), esse método é usado para interromper uma longa consulta em execução ou para cancelar uma consulta que ainda não esteja concluída. No entanto, ao contrário de SQLConnection.cancel(), esse método só cancela a instrução única. Se a instrução não estiver em execução no momento, chamar esse método não terá efeito.

Nenhum evento é despachado em resposta direta à conclusão da operação cancel(). No entanto, uma vez que a operação cancel() esteja concluída e a execução da instrução seja cancelada, a ocorrência SQLStatement despacha um evento error indicando que a execução da instrução (a chamada execute() ou next()) não foi concluída. Como alternativa, se um valor foi especificado para o parâmetro responder da chamada execute() ou next(), o método do manipulador de faltas especificado é chamado. Em ambos os casos, a instância SQLError que é passada aos ouvintes terá uma propriedade errorID com um valor de 3118 (Operação abortada).

    clearParameters

()método 
public function clearParameters():void

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

Limpa todas as definições de parâmetros atuais.

Elementos da API relacionados

    execute

()método 
public function execute(prefetch:int = -1, responder:Responder = null):void

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

Executa a SQL na propriedade text contra o banco de dados que está conectado ao objeto SQLConnection na propriedade sqlConnection.

No modo de execução assíncrono, se o argumento responder não for null, o objeto Responder especificado indicará os métodos que serão chamados para manipular os resultados da operação. Se o argumento responder for null, no modo de execução assíncrono, um evento result será despachado se a operação for bem-sucedida, ou um evento error será despachado se a operação falhar.

Acessar os resultados de uma instrução, tais como as linhas de resultado da instrução SELECT ou o banco de dados que gerou a chave primária de uma instrução INSERT, chame o método getResult(). Os resultados estão disponíveis imediatamente depois que a instrução realiza no modo síncrono e quando o evento result é despachado no modo assíncrono.

Cada instrução deve ser preparada (compilada) antes que possa ser executada. A primeira vez que um método execute() da instrução SQLStatement é chamado, a instrução é preparada pelo tempo de execução. Uma vez que a instrução esteja preparada, ela não precisará ser preparada novamente, a não ser que a propriedade text seja alterada. Definir um ou mais valores de parâmetros não requer que a instrução seja preparada novamente.

Parâmetros

prefetch:int (default = -1) — Quando a propriedade text da instrução for uma instrução SELECT, o valor indicará quantas linhas são retornadas por vez pela instrução. O valor padrão é -1, indicando que todas as linhas de resultado são retornadas de uma vez. Esse parâmetro é usado em conjunto com o método next() para dividir grandes conjuntos de resultados em conjuntos menores de dados. Isso pode melhorar a percepção do usuário do desempenho do aplicativo retornando resultados iniciais mais rapidamente e dividindo as operações de processamento de resultados.

Quando a instrução SQL é uma consulta SELECT e é especificado um argumento prefetch maior do que zero, a instrução é considerada em execução até que o conjunto inteiro de resultados seja retornado, até que o método SQLStatement.cancel() ou o SQLConnection.cancel() seja chamado. Observe que, uma vez que o número de linhas em um conjunto de resultados é desconhecido no tempo de execução, o cursor do banco de dados deve mover-se além da última linha no conjunto de resultados para que a instrução seja considerada concluída. Quando um argumento prefetch é especificado em uma chamada execute(), pelo menos uma linha a mais do que o número total de linhas no conjunto de resultados deve ser solicitada (seja por intermédio do valor prefetch que é maior do que o número de linhas no conjunto de resultados, ou por intermédio de chamadas subsequentes do método next()) para que a propriedade complete da ocorrência SQLResult seja true.

 
responder:Responder (default = null) — Um objeto que designa métodos a ser chamados quando a operação é bem-sucedida ou apresenta falha. No modo de execução assíncrono, se o argumento responder for null, um evento result ou error será despachado quando a execução for concluída.


Eventos
result:SQLEvent — Despachado quando a execução da instrução é concluída com êxito, ou quando um valor do argumento prefetch é especificado e uma instrução SELECT retorna uma ou mais linhas de dados.
 
error:SQLErrorEvent — Despachado quando a operação falha no modo de execução assíncrona.

Lança
IllegalOperationError — Se a propriedade text for null ou contiver uma string vazia (""); se a propriedade sqlConnection não estiver definida, se a instância SQLConnection atribuída à propriedade sqlConnection não estiver conectada ou se a instrução estiver sendo executada no momento.
 
SQLError — Se a operação falhar no modo de execução sincrônica.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

O exemplo a seguir demonstra a execução de uma SQLStatement, utilizando ouvintes de eventos para determinar quando a execução da instrução é concluída ou apresenta falha.
var conn:SQLConnection;
var dbStatement:SQLStatement;

function init():void
{
    conn = new SQLConnection();
    conn.addEventListener(SQLEvent.OPEN, connOpenHandler);
    
    dbStatement = new SQLStatement();
    dbStatement.sqlConnection = conn;
    dbStatement.text = "SELECT id, name, ssn FROM employees";
    
    var dbFile:File = new File(File.separator + "employee.db");
    conn.open(dbFile);
}

function connOpenHandler(event:SQLEvent):void
{
    dbStatement.addEventListener(SQLEvent.RESULT, resultHandler);
    dbStatement.addEventListener(SQLErrorEvent.ERROR, errorHandler);
    dbStatement.execute();
}

function resultHandler(event:SQLEvent):void
{
    var result:SQLResult = dbStatement.getResult();
    if (result != null)
    {
        var numRows:int = result.data.length;
        for (var i:int = 0; i < numRows; i++)
        {
            var row:Object = result.data[i];
            trace("id:", row.id, ", name:", row.name, ", ssn:", row.ssn);
        }
    }
}

function errorHandler(event:SQLErrorEvent):void
{
    trace("An error occured while executing the statement.");
}

O exemplo a seguir demonstra a execução de uma SQLStatement, utilizando um objeto Responder para indicar que funções são chamadas quando a execução da instrução é concluída ou apresenta falha.
var conn:SQLConnection;
var dbStatement:SQLStatement;
var employeeResponder:Responder;

function init():void
{
    conn = new SQLConnection();
    conn.addEventListener(SQLEvent.OPEN, connOpenHandler);
    
    dbStatement = new SQLStatement();
    dbStatement.sqlConnection = conn;
    dbStatement.text = "SELECT id, name, ssn FROM employees";
    
    var dbFile:File = new File(File.separator + "employee.db");
    conn.open(dbFile);
}

function connOpenHandler(event:SQLEvent):void
{
    employeeResponder = new Responder(resultHandler, errorHandler);
    dbStatement.execute(-1, employeeResponder);
}

function resultHandler(result:SQLResult):void
{
    if (result != null)
    {
        var numRows:int = result.data.length;
        for (var i:int = 0; i < numRows; i++)
        {
            var row:Object = result.data[i];
            trace("id:", row.id, ", name:", row.name, ", ssn:", row.ssn);
        }
    }
}

function errorHandler(error:SQLError):void
{
    trace("An error occured while executing the statement.");
}

    getResult

()método 
public function getResult():SQLResult

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

Provê acesso a um objeto SQLResult contendo os resultados da execução da instrução, incluindo qualquer linha de resultado de uma instrução SELECT e outras informações sobre a execução da instrução de todas as instruções executadas. No modo de execução assíncrono, as informações sobre resultados não ficam disponíveis até que o evento result seja despachado.

Quando uma instrução SELECT é executada, se o método execute() for chamado com o argumento padrão prefetch de -1, o objeto SQLResult retornado conterá o conjunto de resultados inteiro da consulta.

Quando um argumento prefetch é especificado para uma chamada do método execute() ou next(), o método getResult() comporta-se como uma fila de resultados do tipo primeiro a entrar, primeiro a sair. Toda vez que o evento result é despachado, um novo objeto SQLResult é adicionado à fila. Toda vez que o método getResult() é chamado, o objeto SQLResult mais antigo (aquele que foi adicionado à fila primeiro) é retornado e removido da fila. Quando não há mais objetos restantes SQLResult na fila, getResult() retorna null.

Observe que, a não ser que sejam removidos chamando getResult(), os objetos SQLResult permanecem na fila. Por exemplo, se o método execute() for chamado várias vezes sem chamar getResult(), os objetos SQLResult associados a cada chamada execute() permanecerão na fila.

Retorna
SQLResult — Um objeto SQLResult contendo o resultado de uma chamada para o método execute() ou next().

Elementos da API relacionados

    next

()método 
public function next(prefetch:int = -1, responder:Responder = null):void

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

Recupera a próxima porção de um conjunto de resultados da instrução SELECT. Se não há mais linhas no conjunto de resultados, um evento result é despachado, mas nenhum outro objeto SQLResult é adicionado à fila getResult().

No modo de execução assíncrono, se o argumento responder não for null, o objeto Responder especificado indicará os métodos que serão chamados para manipular os resultados da operação. Se o argumento responder for null, um evento result será despachado se a operação for bem-sucedida, ou um evento error será despachado se a operação falhar.

Esse método só pode ser chamado quando a instrução ainda está em execução. Quando a instrução é uma consulta SELECT e é especificado um argumento prefetch maior do que zero, a instrução é considerada em execução até que o conjunto inteiro de resultados seja retornado, até que o método SQLStatement.cancel() ou SQLConnection.cancel() seja chamado.

Parâmetros

prefetch:int (default = -1) — Quando a propriedade text da instrução for uma instrução SELECT, o valor indicará quantas linhas são retornadas por vez pela instrução. O valor padrão é -1, indicando que todas as linhas de resultado são retornadas de uma vez. Isso pode melhorar a percepção do usuário do desempenho do aplicativo retornando resultados iniciais mais rapidamente e dividindo as operações de processamento de resultados.
 
responder:Responder (default = null) — Um objeto que designa métodos a ser chamados quando a operação é bem-sucedida ou apresenta falha. Se o argumento responder for null, um evento result ou error será despachado quando a execução for concluída.


Eventos
result:SQLEvent — Despachado quando a execução da instrução é concluída com êxito, ou quando um valor do argumento prefetch é especificado e a chamada next() retorna uma ou mais linhas de dados.
 
error:SQLErrorEvent — Despachado quando a operação falha no modo de execução assíncrona.

Lança
IllegalOperationError — Quando o método é chamado quando a instrução não está em execução no momento (a propriedade executing é false).
 
SQLError — se a operação falhar no modo de execução sincrônica.

Elementos da API relacionados


Exemplo  ( Como usar este exemplo )

O exemplo a seguir demonstra a execução de uma SQLStatement, indicando explicitamente que somente as 10 primeiras linhas do conjunto de resultados são retornadas a primeira vez que o resultado é retornado. O código verifica a propriedade complete da SQLResult e, se todas as linhas não tiverem sido recuperadas, chama o método next().
var conn:SQLConnection;
var dbStatement:SQLStatement;

function init():void
{
    conn = new SQLConnection();
    conn.addEventListener(SQLEvent.OPEN, connOpenHandler);
    
    dbStatement = new SQLStatement();
    dbStatement.sqlConnection = conn;
    dbStatement.text = "SELECT id, name, ssn FROM employees";
    
    var dbFile:File = new File(File.separator + "employee.db");
    conn.open(dbFile);
}

function connOpenHandler(event:SQLEvent):void
{
    dbStatement.addEventListener(SQLEvent.RESULT, resultHandler);
    dbStatement.addEventListener(SQLErrorEvent.ERROR, errorHandler);
    dbStatement.execute(10);
}

function resultHandler(event:SQLEvent):void
{
    var result:SQLResult = dbStatement.getResult();
    if (result != null)
    {
        var numRows:int = result.data.length;
        for (var i:int = 0; i < numRows; i++)
        {
            var row:Object = result.data[i];
            trace("id:", row.id, ", name:", row.name, ", ssn:", row.ssn);
        }
        if (!result.complete)
        {
            dbStatement.next(10);
        }
    }
}

function errorHandler(event:SQLErrorEvent):void
{
    trace("An error occured while executing the statement.");
}
Detalhe do evento
    

error

Evento
Tipo do objeto de evento: flash.events.SQLErrorEvent
propriedade SQLErrorEvent.type = flash.events.SQLErrorEvent.ERROR

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

Despachado quando ocorre um erro durante uma operação.

A constante SQLErrorEvent.ERROR define o valor da propriedade type de um evento de erro despachado quando uma chamada para um método de uma instância SQLConnection ou SQLStatement é concluída com um erro. O evento error tem as seguintes propriedades:
PropriedadeValor
bubblesfalse
cancelablefalse; não há comportamento padrão a ser cancelado.
errorUm objeto SQLError contendo informações sobre o tipo de erro que ocorreu e a operação que causou o erro.
currentTargetO objeto que está processando ativamente o objeto de evento com um ouvinte de evento.
targetO objeto SQLConnection ou SQLStatement que relata o erro.

Elementos da API relacionados

    

result

Evento  
Tipo do objeto de evento: flash.events.SQLEvent
propriedade SQLEvent.type = flash.events.SQLEvent.RESULT

Versão da linguagem: ActionScript 3.0
Versões de runtime: AIR 1.0

Despachado quando uma operação de chamada dos métodos execute() ou next() é concluída com êxito. Uma vez que o evento result é despachado, o método getResult() pode ser chamado para recuperar resultados de instruções.

A constante SQLEvent.RESULT define o valor da propriedade type de um objeto de evento result. Despachado quando o método SQLStatement.execute() ou o método SQLStatement.next() foi concluído com sucesso. Assim que o evento SQLEvent.RESULT for despachado, o método SQLStatement.getResult() poderá ser chamado para acessar os dados do resultado. O evento result tem as seguintes propriedades:
PropriedadeValor
bubblesfalse
cancelablefalse; não há comportamento padrão a ser cancelado.
currentTargetO objeto que está processando ativamente o objeto de evento com um ouvinte de evento.
targetO objeto SQLStatement que executou a operação.

Elementos da API relacionados





[ X ]Por que inglês?
O conteúdo na Referência do ActionScript 3.0 aparece em inglês

Nem todas as partes da Referência do ActionScript 3.0 estão traduzidas em todos os idiomas. Quando um elemento de um idioma não está traduzido, ele é exibido em inglês. Por exemplo, a classe ga.controls.HelpBox não está traduzida em nenhum idioma. Por isso, na versão da referência em português do Brasil, a classe ga.controls.HelpBox é exibida em inglês.