SqlDataSourceSelectingEventArgs 類別

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

提供 Selecting 控制項的 SqlDataSource 事件資料。

public ref class SqlDataSourceSelectingEventArgs : System::Web::UI::WebControls::SqlDataSourceCommandEventArgs

public class SqlDataSourceSelectingEventArgs : System.Web.UI.WebControls.SqlDataSourceCommandEventArgs

type SqlDataSourceSelectingEventArgs = class
    inherit SqlDataSourceCommandEventArgs

Public Class SqlDataSourceSelectingEventArgs
Inherits SqlDataSourceCommandEventArgs

繼承: Object

EventArgs

CancelEventArgs

SqlDataSourceCommandEventArgs
SqlDataSourceSelectingEventArgs

藉由新增事件處理常式委派來處理 Selecting 事件，您可以執行任何其他必要前置處理，或完全取消資料庫查詢。因為類別 SqlDataSourceSelectingEventArgs 衍生自 SqlDataSourceCommandEventArgs 類別，所以您可以將屬性設定 Cancel 為 true 來解除擱置 SqlDataSource 的資料庫查詢。您可以藉由存取 DbCommand 屬性所 Command 公開的物件，先檢查及操作 CommandText 、 Parameters 集合和其他資料庫查詢屬性，再執行查詢。您也可以藉由存取 Arguments 屬性來檢查 DataSourceSelectArguments 傳遞至 Select 方法的物件。

類別 SqlDataSourceSelectingEventArgs 用於方法中 OnSelecting ，以在執行資料庫查詢之前提供資料庫查詢的存取 SqlDataSource 權。

控制項 SqlDataSource 會公開許多事件，您可以在資料作業期間處理基礎資料物件。下表列出事件和相關聯的 EventArgs 類別和事件處理常式委派。

事件	EventArgs	EventHandler
Selecting. 發生于擷取資料之前。	SqlDataSourceSelectingEventArgs	SqlDataSourceSelectingEventHandler
Inserting Updating和 Deleting。發生于執行插入、更新或刪除作業之前。	SqlDataSourceCommandEventArgs	SqlDataSourceCommandEventHandler
Selected、Inserted、Updated 和 Deleted。發生于資料擷取、插入、更新或刪除作業完成之後。	SqlDataSourceStatusEventArgs	SqlDataSourceStatusEventHandler

Arguments	取得傳遞至 DataSourceSelectArguments 方法的 Select(DataSourceSelectArguments) 物件。
Cancel	取得或設定值，這個值表示是否應該取消事件。 (繼承來源 CancelEventArgs)
Command	取得暫止的資料庫命令。 (繼承來源 SqlDataSourceCommandEventArgs)

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)