ButtonColumn.CommandName 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置一个字符串，该字符串表示当单击 ButtonColumn 对象中的按钮时要执行的命令。
public:
virtual property System::String ^ CommandName { System::String ^ get(); void set(System::String ^ value); };public virtual string CommandName { get; set; }member this.CommandName : string with get, setPublic Overridable Property CommandName As String属性值
一个字符串，表示当单击 ButtonColumn 中的按钮时要执行的命令。 默认值为空字符串("")。
示例
下面的代码示例演示如何使用 CommandName 属性将命令名称与按钮相关联。 然后，单击的按钮的命令名称在事件的事件处理程序 ItemCommand 中以编程方式确定，并执行相应的操作。
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected 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(0, AddColumn);
}
protected void ItemsGrid_ItemCommand(object source, DataGridCommandEventArgs e)
{
if (e.CommandName == "Add")
{
// Add logic for addition operation here.
this.TextBox1.Text = "Added";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
<asp:Button ID="Button1" runat="server" Text="Button" /><br />
<asp:DataGrid
ID="ItemsGrid"
runat="server"
DataSourceID="CustomersSqlDataSource"
AutoGenerateColumns="true"
OnItemCommand="ItemsGrid_ItemCommand" />
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
runat="server">
</asp:sqldatasource>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Page_Init(ByVal sender As Object, ByVal 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(0, AddColumn)
End Sub
Protected Sub ItemsGrid_ItemCommand(ByVal source As Object, ByVal e As DataGridCommandEventArgs)
If e.CommandName = "Add" Then
' Add logic for addition operation here.
TextBox1.Text = "Added"
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
<asp:Button ID="Button1" runat="server" Text="Button" /><br />
<asp:DataGrid
ID="ItemsGrid"
runat="server"
DataSourceID="CustomersSqlDataSource"
AutoGenerateColumns="true"
OnItemCommand="ItemsGrid_ItemCommand" />
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
runat="server">
</asp:sqldatasource>
</div>
</form>
</body>
</html>
注解
CommandName使用 属性可将命令名称（如 Add 或 Remove）与按钮相关联。 可以将 属性设置为 CommandName 任何字符串，这些字符串标识单击对象中的 System.Web.UI.WebControls.ButtonColumn 按钮时要执行的操作。 然后，可以编程方式确定事件的事件处理程序 ItemCommand 中的命令名称，并执行相应的操作。
此属性的值存储在视图状态中。
