ButtonColumn 类

DataGrid 控件的列类型，该控件包含一个用户定义的按钮。

**命名空间:**System.Web.UI.WebControls
**程序集:**System.Web（在 system.web.dll 中）

语法

声明
Public Class ButtonColumn
    Inherits DataGridColumn
用法
Dim instance As ButtonColumn

public class ButtonColumn : DataGridColumn

public ref class ButtonColumn : public DataGridColumn

public class ButtonColumn extends DataGridColumn

public class ButtonColumn extends DataGridColumn

备注

使用 DataGrid 控件中的 ButtonColumn 类来创建一个按钮，该按钮与 DataGrid 控件中的每一行相对应。通过设置 Text 属性指定按钮中显示的标题。如果设置了 Text 属性，则 ButtonColumn 对象中的所有按钮均共享同一标题。此外，您还可以将 ButtonColumn 按钮绑定到数据源中的一个字段。这使您可以为每个按钮显示不同的标题。指定字段中的值用于文本标题。设置 DataTextField 属性以将 ButtonColumn 绑定到数据源中的字段。

您可以通过使用格式化字符串设置 DataTextField 属性，来格式化按钮中显示的标题。

单击 ButtonColumn 中的按钮会引发 ItemCommand 事件。通过为 ItemCommand 事件提供事件处理程序，可以编程方式控制单击按钮时所执行的操作。

默认情况下，单击 ButtonColumn 中的按钮时不执行页验证。页验证确定页上与验证控件关联的输入控件是否均通过该验证控件所指定的验证规则。若要在单击按钮时执行页验证，请将 CausesValidation 属性设置为 true。

示例

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

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 'Page_Init 

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 void Page_Init(Object sender, EventArgs e)
{
    // Create dynamic column to add to Columns collection.
    ButtonColumn addColumn = new ButtonColumn();
    addColumn.set_HeaderText("Add Item");
    addColumn.set_Text("Add");
    addColumn.set_CommandName("Add");
    addColumn.set_ButtonType(ButtonColumnType.PushButton);
 

    // Add column to Columns collection.
    itemsGrid.get_Columns().AddAt(2, addColumn);
} //Page_Init

private function Page_Init(sender : Object, e : EventArgs) 
{

   // Create dynamic column to add to Columns collection.
   var AddColumn : ButtonColumn = 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);

}
   

继承层次结构

System.Object
   System.Web.UI.WebControls.DataGridColumn
    System.Web.UI.WebControls.ButtonColumn

线程安全

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。

平台

Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

ButtonColumn 成员
System.Web.UI.WebControls 命名空间
DataGrid
DataGridColumn
BoundColumn 类
EditCommandColumn
HyperLinkColumn
TemplateColumn
Button 类
LinkButton