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

示例

下面的代码示例演示如何使用 ButtonColumn 控件中的 DataGrid 类来创建 “添加” 按钮。

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()	导致跟踪服务器控件的视图状态的更改，以便这些更改可以存储到服务器控件的 StateBag 对象中。 (继承自 DataGridColumn)

显式接口实现

IStateManager.IsTrackingViewState	获取一个值，该值指示该列是否跟踪视图状态更改。 (继承自 DataGridColumn)
IStateManager.LoadViewState(Object)	加载以前保存的状态。 (继承自 DataGridColumn)
IStateManager.SaveViewState()	返回包含状态更改的对象。 (继承自 DataGridColumn)
IStateManager.TrackViewState()	开始跟踪状态更改。 (继承自 DataGridColumn)

另请参阅

• DataGrid
• DataGridColumn
• BoundColumn
• EditCommandColumn
• HyperLinkColumn
• TemplateColumn
• Button
• LinkButton