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 陳述式在執行時，其列識別名稱可以透過 SQLResult 物件 (由 SQLStatement 物件之 getResult() 方法 (當 SQLStatement 傳送其 result 事件之後呼叫) 傳回的 lastInsertRowID 屬性取得)。

如需有關主索引鍵和所產生列識別名稱的詳細資訊，請參閱附錄本機資料庫中的 SQL 支援內的 CREATE TABLE 及運算式小節。

實作
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 常數會定義 SQLConnection 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