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- 继承
示例
下面的代码示例演示如何使用 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 类的新实例。 |
属性
方法
| 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) |
