SQLUpdateEvent

包	flash.events
类	public class SQLUpdateEvent
继承	SQLUpdateEvent Event Object

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

与 SQLConnection 实例关联的任何表发生数据更改时，SQLConnection 对象将调度 SQLUpdateEvent 对象。执行 SQL INSERT、UPDATE 或 DELETE 语句（直接或由于触发与语句执行有关的触发器）可以导致数据更改。

查看示例

相关 API 元素

flash.data.SQLConnection

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		bubbles : Boolean [只读] 表示事件是否为冒泡事件。	Event
		cancelable : Boolean [只读] 表示是否可以阻止与事件相关联的行为。	Event
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [只读] 事件流中的当前阶段。	Event
		rowID : Number [只读] 插入、删除或更新的行的唯一行标识符。	SQLUpdateEvent
		table : String [只读] 其数据更改导致调度事件的表的名称。	SQLUpdateEvent
		target : Object [只读] 事件目标。	Event
		type : String [只读] 事件的类型。	Event

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		SQLUpdateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, table:String = null, rowID:Number = 0) 创建新的 SQLUpdateEvent 实例。	SQLUpdateEvent
		clone():Event [覆盖] 创建 SQLUpdateEvent 对象的副本，并将每个属性的值设置为与原始属性值相匹配。	SQLUpdateEvent
		formatToString(className:String, ... arguments):String 用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。	Event
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isDefaultPrevented():Boolean 检查是否已对事件调用 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		preventDefault():void 如果可以取消事件的默认行为，则取消该行为。	Event
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		stopImmediatePropagation():void 防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。	Event
		stopPropagation():void 防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。	Event
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回一个字符串，其中包含 Event 对象的所有属性。	Event
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义
		DELETE : String = "delete" [静态] SQLUpdateEvent.DELETE 常量定义 SQLConnection delete 事件的 type 属性值。	SQLUpdateEvent
		INSERT : String = "insert" [静态] SQLUpdateEvent.INSERT 常量定义 SQLConnection insert 事件的 type 属性值。	SQLUpdateEvent
		UPDATE : String = "update" [静态] SQLUpdateEvent.UPDATE 常量定义 SQLConnection update 事件的 type 属性值。	SQLUpdateEvent

属性详细信息

rowID

属性

rowID:Number [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

插入、删除或更新的行的唯一行标识符。

行标识符用于唯一标识数据库表中的行。该值通常由数据库生成。

用于单个 SQL INSERT 语句执行的行标识符可以通过由 SQLStatement 对象的 getResult() 方法返回的 SQLResult 对象的 lastInsertRowID 属性获得（在 SQLStatement 调度其 result 事件后调用时）。

有关主键和生成的行标识符的详细信息，请参阅附录“本地数据库中的 SQL 支持”中的“CREATE TABLE”和“Expressions”各节。

实现
public function get rowID():Number

table

属性

table:String [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

其数据更改导致调度事件的表的名称。

实现
public function get table():String

构造函数详细信息

()

构造函数

public function SQLUpdateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, table:String = null, rowID:Number = 0)

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

创建新的 SQLUpdateEvent 实例。

参数

	`type:String` — 事件的类型，可通过 `type` 属性获取。

	`bubbles:Boolean` (default = `false`) — 确定 Event 对象是否参与事件流的冒泡阶段。默认值为 `false`。

	`cancelable:Boolean` (default = `false`) — 确定是否可以取消 Event 对象。默认值为 `false`。

	`table:String` (default = `null`) — 表示数据已更改的表的名称。

	`rowID:Number` (default = `0`) — 插入、删除或更新的行的唯一行标识符。

方法详细信息

clone

()

方法

override public function clone():Event

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

创建 SQLUpdateEvent 对象的副本，并将每个属性的值设置为与原始属性值相匹配。

Event — 其属性值与原始属性值匹配的新 SQLUpdateEvent 对象。

常量详细信息

DELETE

常量

public static const DELETE:String = "delete"

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

SQLUpdateEvent.DELETE 常量定义 SQLConnection delete 事件的 type 属性值。delete 事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`rowID`	插入、删除或更新的行的唯一行标识符。
`target`	对其执行操作的 SQLConnection 对象。
`table`	发生更改的表的名称。

INSERT

常量

public static const INSERT:String = "insert"

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

SQLUpdateEvent.INSERT 常量定义 insert 事件的 type 属性值。insert 事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`rowID`	插入、删除或更新的行的唯一行标识符。
`target`	对其执行操作的 SQLConnection 对象。
`table`	发生更改的表的名称。

UPDATE

常量

public static const UPDATE:String = "update"

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

SQLUpdateEvent.UPDATE 常量定义 SQLConnection update 事件的 type 属性值。

update 事件具有以下属性：

属性	值
`bubbles`	`false`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`rowID`	插入、删除或更新的行的唯一行标识符。
`target`	对其执行操作的 SQLConnection 对象。
`table`	发生更改的表的名称。

示例如何使用本示例

SQLUpdateEvent.class.1.as

以下示例展示 SQLUpdateEvent 实例在响应 update 事件中的用法。


var dbStatement:SQLStatement;

function initConnection():void
{
    var dbFile:File = new File(File.separator + "employee.db");
    db.addEventListener(SQLEvent.OPEN, dbOpenHandler);
    db.addEventListener(SQLUpdateEvent.UPDATE, dbUpdateHandler);

    dbStatement.text = "UPDATE employees SET name = :name WHERE id = :id";
    dbStatement.parameters[:name] = "Bruce";
    dbStatement.parameters[:id] = 100;

    dbStatement.sqlConnection = db;

    db.open(dbFile);
}

function dbUpdateHandler(event:SQLUpdateEvent):void
{
    trace(event.type + " for table '" + event.table + "' was fired for row with ID:" + event.rowID);
}

function dbOpenHandler(event:SQLEvent):void
{
    dbStatement.execute();
}

法律声明 | 在线隐私策略

SQLUpdateEvent - AS3

类 x

rowID

table

SQLUpdateEvent

clone

DELETE

INSERT

UPDATE