Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

EntityDataSource.Selected-Ereignis

Aktualisiert: November 2007

Tritt ein, nachdem eine Abfrage ausgeführt wurde.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web.Entity (in System.Web.Entity.dll)

public event EventHandler<EntityDataSourceSelectedEventArgs> Selected
/** @event */
public void add_Selected (EventHandler<EntityDataSourceSelectedEventArgs> value)
/** @event */
public void remove_Selected (EventHandler<EntityDataSourceSelectedEventArgs> value)

JScript unterstützt keine Ereignisse.
<asp:EntityDataSource OnSelected="EventHandler" />

Das Selected-Ereignis wird ausgelöst, nachdem eine Abfrage ausgeführt und Daten zurückgegeben wurden. Das Ereignis wird auch ausgelöst, wenn während der Abfragevorbereitung oder -ausführung ein Fehler auftritt.

Die Results-Eigenschaft des EntityDataSourceSelectedEventArgs-Objekts enthält eine IEnumerable-Schnittstelle für Objekte, die von der Abfrage zurückgegeben werden. Behandeln Sie das Selected-Ereignis, um zurückgegebene Entitäten im ViewState abzurufen und zu speichern. Auf diese Weise können Sie Objektänderungen auf der Seite beibehalten.

Die TotalRowCount -Eigenschaft des EntityDataSourceSelectedEventArgs-Objekts zeigt die Gesamtzahl der Objekte in allen Seiten unabhängig von den Werten an, die vom datengebundenen Steuerelement für das Paging übergeben werden. TotalRowCount wird vom datengebundenen Steuerelement nur bei Bedarf abgerufen, etwa wenn das Paging aktiviert ist.

Wenn beim Vorbereiten oder Ausführen der Abfrage ein Fehler auftritt, wird das Selected-Ereignis ausgelöst. Außerdem wird die Exception-Eigenschaft des EntityDataSourceSelectedEventArgs-Objekts auf die zurückgegebene Exception festgelegt, und die Results-Eigenschaft wird auf null festgelegt. Legen Sie die ExceptionHandled-Eigenschaft auf true fest, wenn Sie die Ausnahme im Selected-Ereignishandler behandeln. Dies verhindert, dass die Ausnahme erneut ausgelöst wird. Wenn Sie den Wert false für die ExceptionHandled-Eigenschaft angeben, löst die EntityDataSource die Ausnahme erneut aus.

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5 SP1
Anzeigen: