ButtonColumn 類別

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

DataGrid 控制項的資料行類型，包含使用者定義的按鈕。

public ref class ButtonColumn : System::Web::UI::WebControls::DataGridColumn
public class ButtonColumn : System.Web.UI.WebControls.DataGridColumn
type ButtonColumn = class
    inherit DataGridColumn
Public Class ButtonColumn
Inherits DataGridColumn
繼承
Object
DataGridColumn
ButtonColumn

範例

下列程式碼範例示範如何在 控制項中使用 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)

適用於

另請參閱