ButtonFieldBase 類別

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

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

可作為按鈕欄位的抽象基底類別，例如 ButtonField 或 CommandField 類別。 ButtonFieldBase 類別提供通用於所有按鈕欄位的方法和屬性。

public ref class ButtonFieldBase abstract : System::Web::UI::WebControls::DataControlField

public abstract class ButtonFieldBase : System.Web.UI.WebControls.DataControlField

type ButtonFieldBase = class
    inherit DataControlField

Public MustInherit Class ButtonFieldBase
Inherits DataControlField

繼承: Object

DataControlField
ButtonFieldBase

衍生: System.Web.UI.WebControls.ButtonField

System.Web.UI.WebControls.CommandField

備註

類別 ButtonFieldBase 是按鈕欄位的抽象基類，其中包含所有按鈕欄位通用的方法和屬性。因為這個類別是抽象的，所以您無法直接建立它的實例。相反地，您必須建立繼承自 ButtonFieldBase 類別的非抽象類別實例，例如 ButtonField 或 CommandField 類別。

衍生自 ButtonFieldBase 的物件是由資料繫結控制項所使用， (例如 GridView 和 DetailsView 控制項) 顯示每個記錄的一或多個按鈕。根據所使用的資料繫結控制項，按鈕欄位會以不同的方式顯示。例如，控制項會將 GridView 按鈕欄位顯示為數據行，而控制項則會 DetailsView 將其顯示為數據列。

按一下按鈕欄位中的按鈕會引發父資料繫結控制項的命令事件。您可以藉由提供命令事件的事件處理常式，提供自訂常式，以在按一下按鈕時執行。

注意

控制項 GridView 會 RowCommand 引發事件，而 DetailsView 控制項則會 ItemCommand 引發事件。

若要指定要顯示的按鈕類型，請使用 ButtonType 屬性。若要顯示或隱藏物件的標頭區段 ButtonFieldBase ，請設定 ShowHeader 屬性。

注意

某些資料繫結控制項 (例如 GridView 控制項) 只能顯示或隱藏控制項的整個標頭區段。這些資料繫結控制項不支援 ShowHeader 個別按鈕欄位的屬性。若要顯示或隱藏資料繫結控制項的整個標頭區段， (如果有可用) ，請使用 ShowHeader 控制項的屬性。

給實施者的注意事項

當您繼承自類別時 ButtonFieldBase ，必須覆寫下列成員： CopyProperties(DataControlField) 。

建構函式

ButtonFieldBase()

初始化 ButtonFieldBase 類別的新執行個體。

屬性

AccessibleHeaderText	取得或設定在部分控制項中呈現為 `AbbreviatedText` 屬性值的文字。 (繼承來源 DataControlField)
ButtonType	取得或設定要在按鈕欄位中顯示的按鈕類型。
CausesValidation	取得或設定值，表示是否在按一下 ButtonFieldBase 物件中的按鈕時執行驗證。
Control	取得與 DataControlField 物件關聯之資料控制項的參考。 (繼承來源 DataControlField)
ControlStyle	取得 DataControlField 物件內含之任何 Web 伺服器控制項的樣式。 (繼承來源 DataControlField)
DesignMode	取得值，指示目前是否在設計階段環境中檢視資料控制項欄位。 (繼承來源 DataControlField)
FooterStyle	取得或設定資料控制項欄位的頁尾樣式。 (繼承來源 DataControlField)
FooterText	取得或設定顯示在資料控制項欄位之頁尾項目中的文字。 (繼承來源 DataControlField)
HeaderImageUrl	取得或設定顯示在資料控制項欄位的標頭項目中之影像的 URL。 (繼承來源 DataControlField)
HeaderStyle	取得或設定資料控制項欄位的標頭樣式。 (繼承來源 DataControlField)
HeaderText	取得或設定顯示在資料控制項欄位之標頭項目中的文字。 (繼承來源 DataControlField)
InsertVisible	取得值，指示 DataControlField 物件在其父資料繫結控制項處於插入模式時是否可見。 (繼承來源 DataControlField)
IsTrackingViewState	取得值，指出 DataControlField 物件是否正在將變更儲存到它的檢視狀態。 (繼承來源 DataControlField)
ItemStyle	取得由資料控制項欄位顯示之任何文字基礎內容的樣式。 (繼承來源 DataControlField)
ShowHeader	取得或設定值，表示是否在 ButtonFieldBase 物件中顯示標頭區段。
SortExpression	取得或設定資料來源控制項用於排序資料的排序運算式。 (繼承來源 DataControlField)
ValidateRequestMode	取得或設定值，這個值會指定控制項是否驗證用戶端輸入。 (繼承來源 DataControlField)
ValidationGroup	取得或設定在按一下 ButtonFieldBase 物件中的按鈕時要驗證的驗證控制項群組名稱。
ViewState	取得狀態資訊的字典，允許您在相同頁面的多個要求之間，儲存和還原 DataControlField 物件的檢視狀態。 (繼承來源 DataControlField)
Visible	取得或設定值，指示是否呈現資料控制項欄位。 (繼承來源 DataControlField)

方法

CloneField()	建立目前 DataControlField 衍生物件的複本。 (繼承來源 DataControlField)
CopyProperties(DataControlField)	將衍生自 ButtonFieldBase 類別之目前物件的屬性，複製到指定之 DataControlField 物件。
CreateField()	在衍生類別中覆寫時，建立空白 DataControlField 衍生物件。 (繼承來源 DataControlField)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	從目前資料表儲存格中擷取資料控制項欄位的值，並將值加入至指定的 IDictionary 集合。 (繼承來源 DataControlField)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
Initialize(Boolean, Control)	執行資料控制項欄位的基本執行個體初始化。 (繼承來源 DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	將文字或控制項加入至儲存格的控制項集合。 (繼承來源 DataControlField)
LoadViewState(Object)	將資料來源檢視還原成之前所儲存的檢視狀態。 (繼承來源 DataControlField)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnFieldChanged()	引發 `FieldChanged` 事件。 (繼承來源 DataControlField)
SaveViewState()	儲存自頁面回傳至伺服器以來對 DataControlField 檢視狀態所做的變更。 (繼承來源 DataControlField)
ToString()	傳回字串，表示這個 DataControlField 物件。 (繼承來源 DataControlField)
TrackViewState()	會造成 DataControlField 物件追蹤其檢視狀態變更，以將這些變更儲存在控制項的 ViewState 屬性中，並持續存取相同頁面的其他要求。 (繼承來源 DataControlField)
ValidateSupportsCallback()	在衍生類別中覆寫時，表示欄位所包含的控制項支援回呼 (Callback)。 (繼承來源 DataControlField)

明確介面實作

IDataSourceViewSchemaAccessor.DataSourceViewSchema	取得或設定與此 DataControlField 物件相關聯的結構描述。 (繼承來源 DataControlField)
IStateManager.IsTrackingViewState	取得值，指出 DataControlField 物件是否正在將變更儲存到它的檢視狀態。 (繼承來源 DataControlField)
IStateManager.LoadViewState(Object)	將資料控制項欄位還原成先前儲存的檢視狀態。 (繼承來源 DataControlField)
IStateManager.SaveViewState()	儲存自頁面回傳至伺服器以來對 DataControlField 檢視狀態所做的變更。 (繼承來源 DataControlField)
IStateManager.TrackViewState()	會造成 DataControlField 物件追蹤其檢視狀態變更，以將這些變更儲存在控制項的 ViewState 屬性中，並持續存取相同頁面的其他要求。 (繼承來源 DataControlField)

適用於

ButtonFieldBase 類別

定義

備註

給實施者的注意事項

建構函式

屬性

方法

明確介面實作

適用於

另請參閱

意見反應

其他資源