Gewusst wie: Behandlung von Datenereignissen

Sie können die Anwendung anpassen, indem Sie Code schreiben, der ausgeführt wird, wenn bestimmte Datenereignisse eintreten.Sie können beispielsweise Code schreiben, der ausgeführt wird, wenn Datenzeilen in einer Tabelle erstellt, geändert oder gelöscht werden.Sie können auch Code schreiben, um zu überprüfen, ob ein Benutzer über die Berechtigung zum Ändern der Datenquelle verfügt.

Die Ereignisse, die Sie behandeln können, lassen sich in sechs Kategorien gruppieren:

• Allgemeine Methoden, die ausgeführt werden, wenn Daten erstellt, gelöscht oder geändert werden.

• Zugriffssteuerungsmethoden, die ausgeführt werden, wenn Daten erstellt, gelöscht oder geändert werden.

• Abfragemethoden, die ausgeführt werden, wenn eine Datenquelle abgefragt wird.

• Datenquellenmethoden, die ausgeführt werden, wenn in einer Datenquelle gespeichert wird.

• Eigenschaftenmethoden, die ausgeführt werden, wenn eine Eigenschaft geändert wird.

Eine Beschreibung dieser Methoden ist in den Tabellen am Ende dieses Themas enthalten.

So behandeln Sie ein datenbezogenes Ereignis

1. Doppelklicken Sie im Projektmappen-Explorer auf eine Entität oder Tabelle.

   Die Entität bzw. die Tabelle wird im Daten-Designer geöffnet.

2. Klicken Sie auf der Befehlsleiste im Daten-Designer auf den Pfeil neben der Schaltfläche Code schreiben, und wählen Sie eine Methode aus, die Sie überschreiben möchten.In den folgenden Tabellen sind die Methoden aufgeführt, die von der Anwendung behandelt werden können.

   Hinweis
   Die Eigenschaftenmethoden werden nur in der Dropdownliste Code schreiben angezeigt, wenn im Daten-Designer eine Eigenschaft ausgewählt wurde.

   Der Code-Editor wird geöffnet.

3. Platzieren Sie den Cursor in der Methode, die gerade erstellt wurde, und geben Sie den Code ein, der bei Eintreten des Ereignisses ausgeführt werden soll.

Liste datenbezogener Ereignisse

In den folgenden Tabellen sind die Datenereignisse aufgeführt, die von der Anwendung behandelt werden können:

Allgemeine Methoden	Beschreibung
<Tabellenname>_AllowSaveWithErrors	Gibt an, ob das Element gespeichert werden soll, wenn für das Element Validierungsfehler vorhanden sind.Bei Validierungsfehlern im Element wird der Speichervorgang standardmäßig abgebrochen.Wird auf der aufrufenden Ebene ausgeführt.
<Tabellenname>_Created	Wird aufgerufen, nachdem das Element erstellt wurde.Wird auf der Ebene ausgeführt, auf der das Element erstellt wurde.
<Tabellensatzname>_Deleted	Wird unmittelbar nach dem Löschen des Elements aus dem Datenspeicher aufgerufen.Wird auf dem Server ausgeführt.
<Tabellensatzname>_Deleting	Wird unmittelbar vor dem Löschen des Elements aus dem Datenspeicher aufgerufen.Wird auf dem Server ausgeführt.
<Tabellensatzname>_Inserted	Wird unmittelbar nach dem Einfügen des Elements in den Datenspeicher aufgerufen.Wird auf dem Server ausgeführt.
<Tabellensatzname>_Inserting	Wird unmittelbar vor dem Einfügen des Elements in den Datenspeicher aufgerufen.Wird auf dem Server ausgeführt.
<Tabellensatzname>_Updated	Wird unmittelbar nach dem Aktualisieren des Elements im Datenspeicher aufgerufen.Wird auf dem Server ausgeführt.
<Tabellensatzname>_Updating	Wird unmittelbar vor dem Aktualisieren des Elements im Datenspeicher aufgerufen.Wird auf dem Server ausgeführt.
<Tabellensatzname>_Validate	Wird aufgerufen, wenn ein Element auf dem Server überprüft wird.

Zugriffssteuerungsmethoden	Beschreibung
SaveChanges_CanExecute	Wird vor dem Speichern von Änderungen in der Datenquelle aufgerufen, um die Berechtigungsebene des aktuellen Benutzers zu überprüfen.Wird auf dem Server ausgeführt.
<Tabellensatzname>_CanDelete	Wird vor dem Löschen eines Elements aufgerufen, um die Berechtigungsebene des aktuellen Benutzers zu überprüfen.Wird auf dem Server ausgeführt.
<Tabellensatzname>_CanInsert	Wird vor dem Einfügen eines Elements aufgerufen, um die Berechtigungsebene des aktuellen Benutzers zu überprüfen.Wird auf dem Server ausgeführt.
<Tabellensatzname>_CanRead	Wird vor dem Lesen eines Elements aufgerufen, um die Berechtigungsebene des aktuellen Benutzers zu überprüfen.Wird auf dem Server ausgeführt.
<Tabellensatzname>_CanUpdate	Wird vor dem Aktualisieren eines Elements aufgerufen, um die Berechtigungsebene des aktuellen Benutzers zu überprüfen.Wird auf dem Server ausgeführt.

Abfragemethoden	Beschreibung
Query_ExecuteFailed	Wird aufgerufen, wenn die Abfrage nicht ausgeführt wurde.Wird auf dem Server ausgeführt.
Query_Executed	Wird unmittelbar nach dem Ausführen der Abfrage aufgerufen.Diese Methode wird nicht aufgerufen, wenn die Abfrage nicht ausgeführt wird.Wird auf dem Server ausgeführt.
Query_Executing	Wird unmittelbar vor dem Ausführen der Abfrage aufgerufen.Wird auf dem Server ausgeführt.
<Tabellensatzname>_Filter	Wird vor dem Ausführen der Abfrage aufgerufen und ermöglicht weitere Anpassungen.Wird auf dem Server ausgeführt.

Datenquellenmethoden	Beschreibung
SaveChanges_ExecuteFailed	Wird unmittelbar nach einem Fehler beim Speichern in der Datenquelle aufgerufen.Wird auf dem Server ausgeführt.
SaveChanges_Executed	Wird unmittelbar nach dem erfolgreichen Speichern von Änderungen in der Datenquelle aufgerufen.Wird auf dem Server ausgeführt.
SaveChanges_Executing	Wird unmittelbar vor dem Speichern von Änderungen in der Datenquelle aufgerufen.Wird auf dem Server ausgeführt.

Eigenschaftenmethoden
<Eigenschaftenname>_Changed	Wird unmittelbar nach dem Ändern des Eigenschaftswerts für ein Element aufgerufen.Wird auf der Ebene ausgeführt, auf der die Eigenschaft geändert wurde.
<Eigenschaftenname>_IsReadOnly	Gibt zurück, ob die Eigenschaft schreibgeschützt ist.Wird auf der Ebene ausgeführt, auf der auf die Eigenschaft zugegriffen wird.
<Eigenschaftenname>_Validate	Wird aufgerufen, wenn die Eigenschaft überprüft wird.Wird auf der Ebene ausgeführt, auf der die Eigenschaft überprüft wird.

Siehe auch

Aufgaben

Gewusst wie: Behandeln von Silverlight-Bildschirmereignissen

Gewusst wie: Behandlung von Abfrageereignissen

Weitere Ressourcen

Daten: Die der Anwendung zugrunde liegenden Informationen