AccessDataSourceView.ExecuteSelect(DataSourceSelectArguments) 方法

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

使用 SelectCommand 屬性中的 SQL 字串，以及 SelectParameters 集合中的任何參數，從基礎資料儲存區擷取資料。

protected public:
 override System::Collections::IEnumerable ^ ExecuteSelect(System::Web::UI::DataSourceSelectArguments ^ arguments);

protected internal override System.Collections.IEnumerable ExecuteSelect (System.Web.UI.DataSourceSelectArguments arguments);

override this.ExecuteSelect : System.Web.UI.DataSourceSelectArguments -> System.Collections.IEnumerable

Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

參數

arguments

DataSourceSelectArguments

DataSourceSelectArguments，用於針對資料要求基本資料擷取以外的作業。

傳回

IEnumerable

資料列的 IEnumerable。

例外狀況

InvalidOperationException

DataFile 屬性為 null 或空字串 ("")。

NotSupportedException

傳遞給 ExecuteSelect(DataSourceSelectArguments) 方法的 arguments 指定資料來源應在擷取資料時執行一些額外工作，以透過擷取的資料啟用分頁或排序，但是資料來源控制項不支援所要求的功能。

備註

物件 AccessDataSourceView 會 ExecuteSelect 覆寫 方法，以確保 DataFile 在擷取資料之前，已設定其相關聯 AccessDataSource 控制項的 屬性。

ExecuteSelect在執行 方法之前，會 OnSelecting 呼叫 方法來引發 Selecting 事件。 您可以處理 Selecting 事件來檢查參數的值，並在資料擷取作業之前執行任何前置處理。

若要執行資料擷取， AccessDataSourceView 物件會使用 SelectCommand 文字和任何相關聯的 SelectParameters 屬性來建置 IDbCommand 物件。 然後， AccessDataSourceView 物件會針對基礎資料儲存體執行 IDbCommand 物件。 作業完成之後， OnSelected 會呼叫 方法來引發 Selected 事件。 您可以處理 Selected 事件來檢查任何傳回值和錯誤碼，以及執行任何後續處理。

DataSourceMode如果屬性設定為 DataSet 值，且已啟用快取，則會 AccessDataSourceView 從 擷取資料，並在資料擷取作業期間將資料儲存至快取。 根據 和 CacheExpirationPolicy 屬性的組合 CacheDuration 所指定的快取行為，建立、捨棄或重新整理快取。

DataSourceMode如果屬性設定為 DataSet 值且 FilterExpression 已指定屬性， DataSourceMode 則會評估屬性以及任何提供 FilterParameters 的屬性，並在作業期間 Select 將產生的篩選套用至資料清單。

另請參閱

• AccessDataSource
• DataFile
• ExecuteSelect(DataSourceSelectArguments)