EntityDataSource.Selected EntityDataSource.Selected EntityDataSource.Selected EntityDataSource.Selected Event

定義

クエリが実行された後に発生します。Occurs after a query has been executed.

public:
 event EventHandler<System::Web::UI::WebControls::EntityDataSourceSelectedEventArgs ^> ^ Selected;
public event EventHandler<System.Web.UI.WebControls.EntityDataSourceSelectedEventArgs> Selected;
member this.Selected : EventHandler<System.Web.UI.WebControls.EntityDataSourceSelectedEventArgs> 
Public Custom Event Selected As EventHandler(Of EntityDataSourceSelectedEventArgs) 

注釈

Selectedイベントは、クエリが実行され、データが返された後に発生します。The Selected event is raised after a query has been executed and data has been returned. また、クエリの準備中または実行中にエラーが発生した場合にも発生します。It is also raised if an error occurred during query preparation or execution.

オブジェクトのプロパティにResultsは、クエリIEnumerableから返されるオブジェクトのが含まれています。 EntityDataSourceSelectedEventArgsThe Results property of the EntityDataSourceSelectedEventArgs object contains an IEnumerable of objects that are returned from the query. で返されたエンティティを取得して格納するためのSelectedイベントを処理します。 ViewStateHandle the Selected event to retrieve and store returned entities in the ViewState. これは、オブジェクトの変更をページに保持するために行います。Do this to persist object changes on the page.

オブジェクトのプロパティはTotalRowCount 、ページングのためにデータバインドコントロールによって渡された値に関係なく、すべてのページに含まれるオブジェクトの合計数を示します。 EntityDataSourceSelectedEventArgsThe TotalRowCount property of the EntityDataSourceSelectedEventArgs object shows the total number of objects in all pages, regardless of the values passed by the data-bound control for paging. TotalRowCountは、ページングが有効になっている場合など、データバインドコントロールで必要な場合にのみ取得されます。TotalRowCount is only retrieved if the data-bound control needs it, such as if paging is enabled.

クエリの準備中または実行Selected時にエラーが発生した場合は、イベントが発生ExceptionEntityDataSourceSelectedEventArgs 、オブジェクトのプロパティResultsは返さExceptionれたに設定され、 nullプロパティはに設定されます。If an error occurs when the query is prepared or executed, the Selected event is raised, the Exception property of the EntityDataSourceSelectedEventArgs object is set to the returned Exception, and the Results property is set to null. Selectedイベントハンドラーで例外を処理する場合は、 ExceptionHandledプロパティをにtrue設定します。If you handle the exception in the Selected event handler, set the ExceptionHandled property to true. これにより、例外が再度発生するのを防ぐことができます。This prevents the exception from being raised again. falseプロパティに値を指定すると、はEntityDataSource例外を再発生させます。 ExceptionHandledWhen you specify a value of false for the ExceptionHandled property, the EntityDataSource re-raises the exception.

適用対象