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 中以程式設計方式判斷命令名稱，並執行適當的動作。
此屬性的值會儲存在檢視狀態中。
