ButtonColumn 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
DataGrid 控制項的資料行類型，包含使用者定義的按鈕。
public ref class ButtonColumn : System::Web::UI::WebControls::DataGridColumnpublic class ButtonColumn : System.Web.UI.WebControls.DataGridColumntype ButtonColumn = class
inherit DataGridColumnPublic Class ButtonColumn
Inherits DataGridColumn- 繼承
範例
下列程式碼範例示範如何在 控制項中使用 ButtonColumnDataGrid 類別來建立 [新增 ] 按鈕。
private void Page_Init(Object sender, EventArgs e)
{
// Create dynamic column to add to Columns collection.
ButtonColumn AddColumn = new ButtonColumn();
AddColumn.HeaderText="Add Item";
AddColumn.Text="Add";
AddColumn.CommandName="Add";
AddColumn.ButtonType = ButtonColumnType.PushButton;
// Add column to Columns collection.
ItemsGrid.Columns.AddAt(2, AddColumn);
}
Private Sub Page_Init(sender As Object, e As EventArgs)
' Create dynamic column to add to Columns collection.
Dim AddColumn As New ButtonColumn()
AddColumn.HeaderText = "Add Item"
AddColumn.Text = "Add"
AddColumn.CommandName = "Add"
AddColumn.ButtonType = ButtonColumnType.PushButton
' Add column to Columns collection.
ItemsGrid.Columns.AddAt(2, AddColumn)
End Sub
備註
ButtonColumn使用 控制項中的 DataGrid 類別，建立與 控制項中 DataGrid 每個資料列對應的按鈕。 藉由設定 Text 屬性，指定按鈕中顯示的標題。 如果您設定 Text 屬性，物件中的所有 ButtonColumn 按鈕都會共用相同的標題。 或者，您可以將按鈕系結 ButtonColumn 至資料來源中的欄位。 這可讓您顯示每個按鈕的不同標題。 指定欄位中的值會用於文字標題。 DataTextField設定 屬性以系結 ButtonColumn 至資料來源中的欄位。
您可以使用格式化字串來設定 DataTextField 屬性，以格式化按鈕中顯示的標題。
按一下 中的 ButtonColumn 按鈕會 ItemCommand 引發 事件。 您可以藉由提供事件的事件處理常式 ItemCommand ，以程式設計方式控制按一下按鈕時所執行的動作。
根據預設，按一下 中的 ButtonColumn 按鈕時，不會執行頁面驗證。 頁面驗證會決定與頁面上驗證控制項相關聯的輸入控制項是否都通過驗證控制項所指定的驗證規則。 若要在按一下按鈕時執行頁面驗證，請將 CausesValidation 屬性設定為 true 。
建構函式
| ButtonColumn() |
初始化 ButtonColumn 類別的新執行個體。 |
屬性
| ButtonType |
取得或設定要顯示於 ButtonColumn 物件中的按鈕類型。 |
| CausesValidation |
取得或設定值，表示按一下 ButtonColumn 物件中的按鈕時，是否執行驗證。 |
| CommandName |
取得或設定字串，表示當按一下 ButtonColumn 物件中的按鈕時要執行的命令。 |
| DataTextField |
取得或設定資料來源中的欄位名稱，以繫結至 ButtonColumn 物件。 |
| DataTextFormatString |
取得或設定字串，指定各個按鈕中標題的顯示格式。 |
| DesignMode |
取得值，指出資料行是否處在設計模式中。 (繼承來源 DataGridColumn) |
| FooterStyle |
取得資料行行尾區段的樣式屬性。 (繼承來源 DataGridColumn) |
| FooterText |
取得或設定顯示於資料行行尾區段的文字。 (繼承來源 DataGridColumn) |
| HeaderImageUrl |
取得或設定要顯示於資料行行首區段的影像位置。 (繼承來源 DataGridColumn) |
| HeaderStyle |
取得資料行行首區段的樣式屬性。 (繼承來源 DataGridColumn) |
| HeaderText |
取得或設定顯示於資料行行首區段的文字。 (繼承來源 DataGridColumn) |
| IsTrackingViewState |
取得值，判斷是否標記 DataGridColumn 物件以儲存其狀態。 (繼承來源 DataGridColumn) |
| ItemStyle |
取得資料行項目儲存格的樣式屬性。 (繼承來源 DataGridColumn) |
| Owner |
取得有資料行做為其中成員的 DataGrid 控制項。 (繼承來源 DataGridColumn) |
| SortExpression |
在選取資料行來排序時，取得或設定欄位或運算式的名稱以傳遞至 OnSortCommand(DataGridSortCommandEventArgs) 方法。 (繼承來源 DataGridColumn) |
| Text |
取得或設定顯示於 ButtonColumn 物件中按鈕的標題。 |
| ValidationGroup |
取得或設定驗證控制項群組，ButtonColumn 物件會在回傳至伺服器時，針對這個群組進行驗證。 |
| ViewState |
取得 StateBag 物件，該物件允許衍生自 DataGridColumn 類別的資料行儲存其屬性。 (繼承來源 DataGridColumn) |
| Visible |
取得或設定值，指出資料行是否可見於 DataGrid 控制項中。 (繼承來源 DataGridColumn) |
方法
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| FormatDataTextValue(Object) |
將指定的值轉換為 DataTextFormatString 屬性所表示的格式。 |
| GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
| GetType() |
取得目前執行個體的 Type。 (繼承來源 Object) |
| Initialize() |
將 ButtonColumn 物件重設為它的初始狀態。 |
| InitializeCell(TableCell, Int32, ListItemType) |
將 ButtonColumn 物件中的儲存格重設為它的初始狀態。 |
| LoadViewState(Object) |
載入 DataGridColumn 物件的狀態。 (繼承來源 DataGridColumn) |
| MemberwiseClone() |
建立目前 Object 的淺層複製。 (繼承來源 Object) |
| OnColumnChanged() |
呼叫 OnColumnsChanged() 方法。 (繼承來源 DataGridColumn) |
| SaveViewState() |
儲存 DataGridColumn 物件的目前狀態。 (繼承來源 DataGridColumn) |
| ToString() |
傳回資料行的字串表示。 (繼承來源 DataGridColumn) |
| TrackViewState() |
導致對伺服器控制項的檢視狀態變更的追蹤 (Tracking)，以便它們能夠儲存於伺服器控制項的 StateBag 物件。 (繼承來源 DataGridColumn) |
明確介面實作
| IStateManager.IsTrackingViewState |
取得值，指出資料行是否正在追蹤 (Tracking) 檢視狀態變更。 (繼承來源 DataGridColumn) |
| IStateManager.LoadViewState(Object) |
載入先前儲存的狀態。 (繼承來源 DataGridColumn) |
| IStateManager.SaveViewState() |
傳回包含狀態變更的物件。 (繼承來源 DataGridColumn) |
| IStateManager.TrackViewState() |
啟動追蹤狀態的變更。 (繼承來源 DataGridColumn) |
