EntityDataSource-Ereignisse
Aktualisiert: November 2007
Mit den durch das EntityDataSource-Steuerelement verfügbar gemachten Ereignissen können Sie mehr zu ASP.NET-Anwendungen hinzufügen als in reinen Markupszenarios möglich ist. Ereignishandler können verwendet werden, um Daten zu validieren, Eigenschaftenwerte für nicht datengebundene Eigenschaften bereitzustellen, Informationen über Abfrageergebnisse zu extrahieren und den Lebenszyklus des zum Abfragen und Aktualisieren von Daten verwendeten ObjectContext zu verwalten.
Eine allgemeine Beschreibung von Ereignissen in Datenquellen-Steuerelementen finden Sie unter Events Associated with Inserting, Updating, and Deleting Capabilities of ASP.NET Data controls.
Event |
Beschreibung |
|---|---|
Das ContextCreating-Ereignis stellt eine ObjectContext-Instanz bereit, die vom EntityDataSource-Steuerelement für nachfolgende Operationen verwendet werden soll. Informationen hierzu finden Sie unter Lebenszyklusverwaltung für Objektkontexte |
|
Das ContextCreated-Ereignis ermöglicht den Zugriff auf die ObjectContext-Instanz, die durch das EntityDataSource-Steuerelement erstellt wurde. Dieses Kontextobjekt kann gespeichert werden und außerhalb der EntityDataSource für nachfolgende Operationen verwendet werden. Informationen finden Sie unter Lebenszyklusverwaltung für Objektkontexte |
|
Mit dem ContextDisposing-Ereignis können Sie verhindern, dass der ObjectContext, der vom EntityDataSource-Steuerelement verwendet wird, weitergegeben wird. Behandeln Sie dieses Ereignis, wenn Sie auf Ihrer Seite eine einzige ObjectContext-Instanz für mehrere Steuerelemente oder Instanzen des EntityDataSource-Steuerelements verwenden möchten. |
|
Mit dem Selecting-Ereignis können Sie die Konfiguration der EntityDataSource ändern und die Argumente aus dem datengebundenen Steuerelement lesen oder ändern, bevor die Abfrage erstellt und ausgeführt wird. Behandeln Sie dieses Ereignis, wenn Sie das Paging- oder Sortierverhalten des Steuerelements ändern oder die Abfrage abbrechen möchten. |
|
Das Selected-Ereignis ermöglicht Ihnen den Zugriff auf die Ergebnisse einer Abfrage und das Abrufen von Zeilenanzahlinformationen. Behandeln Sie dieses Ereignis, wenn Sie auf Objektergebnisse zugreifen oder Objekte im Ansichtszustand speichern möchten. |
|
Mit dem Inserting-Ereignis können Sie das hinzugefügte Objekt ändern oder überprüfen, ein anderes Objekt hinzufügen oder den Vorgang abbrechen. Behandeln Sie dieses Ereignis, um auf das Objekt zuzugreifen, das aus der Entity-Eigenschaft des EntityDataSourceChangingEventArgs-Objekts hinzugefügt werden soll. |
|
Das Inserted-Ereignis ermöglicht Ihnen den Zugriff auf ein in der Datenquelle erstelltes Objekt. Die Entity-Eigenschaft des EntityDataSourceChangedEventArgs-Objekts wird für den Zugriff auf das hinzugefügte Objekt verwendet. |
|
Mit dem Updating-Ereignis können Sie Änderungen am Objekt ändern oder überprüfen, ein anderes Objekt angeben oder den Vorgang abbrechen, bevor die Änderungen übernommen werden. Sie können über die Entity-Eigenschaft des EntityDataSourceChangingEventArgs-Objekts auf das geänderte Objekt zugreifen. Behandeln Sie dieses Ereignis, um Änderungen zu überprüfen oder zu validieren oder um den ObjectStateEntry für das Objekt zu ändern, damit andere Originalwerte für die Parallelitätssteuerung festgelegt werden können. Weitere Informationen hierzu finden Sie unter Speichern von Änderungen und Verwalten von Parallelität (Entity Framework). |
|
Das Updated-Ereignis ermöglicht Ihnen den Zugriff auf ein Objekt, an dem Änderungen vorgenommen wurden, die in der Datenquelle beibehalten werden. Die Entity-Eigenschaft des EntityDataSourceChangedEventArgs-Objekts wird für den Zugriff auf das aktualisierte Objekt verwendet. |
|
Mit dem Deleting-Ereignis können Sie auf ein Objekt zugreifen, bevor es aus der Datenquelle gelöscht wird, oder den Vorgang abbrechen. Die Entity-Eigenschaft von EntityDataSourceChangingEventArgs enthält das zu löschende Objekt. |
|
Das Deleted-Ereignis ermöglicht Ihnen, auf ein Objekt zuzugreifen, das aus der Datenquelle gelöscht wurde. Die Entity-Eigenschaft des EntityDataSourceChangingEventArgs-Objekts wird für den Zugriff auf das gelöschte Objekt verwendet. Das zurückgegebene Objekt befindet sich in einem Detached-Zustand. |
|
Exception() |
Das IDynamicDataSource.Exception-Ereignis wird implementiert, um die Kompatibilität mit ASP.NET Dynamic Data zu gewährleisten. Ein Handler für dieses Ereignis kann nicht im Markup registriert werden. Er kann nur verwendet werden, wenn die EntityDataSource-Instanz in eine IDynamicDataSource-Schnittstelle umgewandelt wird. Weitere Informationen hierzu finden Sie unter Übersicht über das ASP.NET Dynamic Data-Modell. |
Siehe auch
Konzepte
Lebenszyklusverwaltung für Objektkontexte (EntityDataSource)
Konfigurieren des EntityDataSource-Steuerelements
Aktualisieren von Daten (EntityDataSource)