SQLUpdateEvent

Paket	flash.events
Klasse	public class SQLUpdateEvent
Vererbung	SQLUpdateEvent Event Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Ein SQLUpdateEvent-Objekt wird von einem SQLConnection-Objekt ausgelöst, wenn in einer Tabelle, die der SQLConnection-Instanz zugeordnet ist, Daten geändert werden. Eine Datenänderung kann auftreten, wenn eine SQL INSERT-, UPDATE- oder DELETE-Anweisung ausgeführt wurde, entweder direkt oder als Ergebnis einer Auslösung in Verbindung mit der Ausführung der Anweisung.

Beispiele anzeigen

Verwandte API-Elemente

flash.data.SQLConnection

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		bubbles : Boolean [schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.	Event
		cancelable : Boolean [schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.	Event
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		currentTarget : Object [schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.	Event
		eventPhase : uint [schreibgeschützt] Die aktuelle Phase im Ereignisablauf.	Event
		rowID : Number [schreibgeschützt] Der eindeutige Zeilenbezeichner der Zeile, die eingefügt, gelöscht oder aktualisiert wurde.	SQLUpdateEvent
		table : String [schreibgeschützt] Der Name der Tabelle, deren Datenänderung zur Auslösung des Ereignisses geführt hat.	SQLUpdateEvent
		target : Object [schreibgeschützt] Das Ereignis-Ziel.	Event
		type : String [schreibgeschützt] Der Ereignistyp.	Event

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		SQLUpdateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, table:String = null, rowID:Number = 0) Erstellt eine neue SQLUpdateEvent-Instanz.	SQLUpdateEvent
		clone():Event [override] Erstellt eine Kopie des SQLUpdateEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.	SQLUpdateEvent
		formatToString(className:String, ... arguments):String Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.	Event
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isDefaultPrevented():Boolean Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.	Event
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		preventDefault():void Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.	Event
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		stopImmediatePropagation():void Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.	Event
		stopPropagation():void Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.	Event
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält.	Event
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Öffentliche Konstanten

Vererbte öffentliche Konstanten ausblenden

Vererbte öffentliche Konstanten anzeigen

	Konstante		Definiert von
		DELETE : String = "delete" [statisch] Die SQLUpdateEvent.DELETE-Konstante definiert den Wert der type-Eigenschaft eines delete-SQLConnection-Ereignisses.	SQLUpdateEvent
		INSERT : String = "insert" [statisch] Die SQLUpdateEvent.INSERT-Konstante definiert den Wert der type-Eigenschaft eines insert-SQLConnection-Ereignisses.	SQLUpdateEvent
		UPDATE : String = "update" [statisch] Die SQLUpdateEvent.UPDATE-Konstante definiert den Wert der type-Eigenschaft eines update-SQLConnection-Ereignisses.	SQLUpdateEvent

Eigenschaftendetails

rowID

Eigenschaft

rowID:Number [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Der eindeutige Zeilenbezeichner der Zeile, die eingefügt, gelöscht oder aktualisiert wurde.

Ein Zeilenbezeichner dient zur eindeutigen Kennzeichnung einer Zeile in einer Tabelle in der Datenbank. Der Wert wird häufig von der Datenbank erzeugt.

Den Zeilenbezeichner für die Ausführung einer SQL INSERT-Anweisung erhalten Sie über die Eigenschaft lastInsertRowID des „SQLResult“-Objekts, das durch die Methode getResult() des „SQLStatement“-Objekts zurückgegeben wird (wenn sie aufgerufen wird, nachdem SQLStatement das result-Ereignis ausgelöst hat).

Weitere Informationen zu Primärschlüsseln und generierten Zeilenbezeichnern finden Sie in den Abschnitten „CREATE TABLE“ und „Ausdrücke“ im Anhang „SQL-Unterstützung in lokalen Datenbanken“.

Implementierung
public function get rowID():Number

Verwandte API-Elemente

flash.data.SQLConnection.lastInsertRowID
flash.data.SQLResult.lastInsertRowID

table

Eigenschaft

table:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Der Name der Tabelle, deren Datenänderung zur Auslösung des Ereignisses geführt hat.

Implementierung
public function get table():String

Konstruktordetails

()

Konstruktor

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

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Erstellt eine neue SQLUpdateEvent-Instanz.

Parameter

	`type:String` — Der Ereignistyp, verfügbar über die `type`-Eigenschaft.

	`bubbles:Boolean` (default = `false`) — Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Der Standardwert ist `false`.

	`cancelable:Boolean` (default = `false`) — Bestimmt, ob das Ereignisobjekt abgebrochen werden kann. Der Standardwert ist `false`.

	`table:String` (default = `null`) — Gibt den Namen der Tabelle an, deren Daten geändert wurden.

	`rowID:Number` (default = `0`) — Der eindeutige Zeilenbezeichner der Zeile, die eingefügt, gelöscht oder aktualisiert wurde.

Methodendetails

clone

()

Methode

override public function clone():Event

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Erstellt eine Kopie des SQLUpdateEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.

Rückgabewerte

Event — Ein neues SQLUpdateEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.

Konstantendetails

DELETE

Konstante

public static const DELETE:String = "delete"

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Die SQLUpdateEvent.DELETE-Konstante definiert den Wert der type-Eigenschaft eines delete-SQLConnection-Ereignisses. Das delete-Ereignis hat folgende Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`rowID`	Der eindeutige Zeilenbezeichner der Zeile, die eingefügt, gelöscht oder aktualisiert wurde.
`target`	Das SQLConnection-Objekt, für das der Vorgang ausgeführt wurde.
`table`	Der Name der Tabelle, in der die Änderung aufgetreten ist.

INSERT

Konstante

public static const INSERT:String = "insert"

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Die SQLUpdateEvent.INSERT-Konstante definiert den Wert der type-Eigenschaft eines insert-SQLConnection-Ereignisses. Das insert-Ereignis hat folgende Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`rowID`	Der eindeutige Zeilenbezeichner der Zeile, die eingefügt, gelöscht oder aktualisiert wurde.
`target`	Das SQLConnection-Objekt, für das der Vorgang ausgeführt wurde.
`table`	Der Name der Tabelle, in der die Änderung aufgetreten ist.

UPDATE

Konstante

public static const UPDATE:String = "update"

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Die SQLUpdateEvent.UPDATE-Konstante definiert den Wert der type-Eigenschaft eines update-SQLConnection-Ereignisses.

Das update-Ereignis hat folgende Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`rowID`	Der eindeutige Zeilenbezeichner der Zeile, die eingefügt, gelöscht oder aktualisiert wurde.
`target`	Das SQLConnection-Objekt, für das der Vorgang ausgeführt wurde.
`table`	Der Name der Tabelle, in der die Änderung aufgetreten ist.

Beispiele Verwendung dieses Beispiels

SQLUpdateEvent.class.1.as

Im folgenden Beispiel wird die Verwendung einer SQLUpdateEvent-Instanz als Antwort auf ein update-Ereignis gezeigt.

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();
}

Rechtliche Hinweise | Onlinedatenschutzerklärung

SQLUpdateEvent - AS3

Klassen x

rowID

table

SQLUpdateEvent

clone

DELETE

INSERT

UPDATE