Button..::.CommandName 属性

最新推荐文章于 2017-06-26 15:10:56 发布

lionvsme

最新推荐文章于 2017-06-26 15:10:56 发布

阅读量192

点赞数

文章标签： ASP ASP.net 编程 .net XHTML

获取或设置命令名，该命令名与传递给 Command 事件的 Button 控件相关联。

ASP.NET

属性值

类型： System..::.String

Button 控件的命令名。默认值为 String..::.Empty。

实现

IButtonControl..::.CommandName

备注

当在网页上具有多个 Button 控件时，可使用 CommandName 属性来指定或确定与每一 Button 控件关联的命令名。可以用标识要执行的命令的任何字符串来设置 CommandName 属性。然后，可以以编程方式确定 Button 控件的命令名并执行相应的操作。

有关命令的附加信息（如 Ascending）可以使用 CommandArgument 属性来指定。

无法通过主题或样式表主题设置此属性。有关更多信息，请参见 ThemeableAttribute和 ASP.NET 主题和外观概述。

示例

下面的代码示例演示如何使用 CommandName 属性来创建对列表进行排序的 Button 控件。

<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html >
<head runat="server">
<title>Button CommandName Example</title>
<script runat="server">

void CommandBtn_Click(Object sender, CommandEventArgs e)
{

switch(e.CommandName)
{

case "Sort":

// Call the method to sort the list.
Sort_List((String)e.CommandArgument);
break;

case "Submit":

// Display a message for the Submit button being clicked.
Message.Text = "You clicked the Submit button";

// Test whether the command argument is an empty string ("").
if((String)e.CommandArgument == "")
{
// End the message.
Message.Text += ".";
}
else
{
// Display an error message for the command argument.
Message.Text += ", however the command argument is not recogized.";
}
break;

default:

// The command name is not recognized. Display an error message.
Message.Text = "Command name not recogized.";
break;

}

}

void Sort_List(string commandArgument)
{

switch(commandArgument)
{

case "Ascending":

// Insert code to sort the list in ascending order here.
Message.Text = "You clicked the Sort Ascending button.";
break;

case "Descending":

// Insert code to sort the list in descending order here.
Message.Text = "You clicked the Sort Descending button.";
break;

default:

// The command argument is not recognized. Display an error message.
Message.Text = "Command argument not recogized.";
break;

}

}

</script>

</head>

<body>

<form id="form1" runat="server">

<h3>Button CommandName Example</h3>

Click on one of the command buttons.

<br /><br />

<asp:Button id="Button1"
Text="Sort Ascending"
CommandName="Sort"
CommandArgument="Ascending"
OnCommand="CommandBtn_Click"
runat="server"/>

 

<asp:Button id="Button2"
Text="Sort Descending"
CommandName="Sort"
CommandArgument="Descending"
OnCommand="CommandBtn_Click"
runat="server"/>

<br /><br />

<asp:Button id="Button3"
Text="Submit"
CommandName="Submit"
OnCommand="CommandBtn_Click"
runat="server"/>

 

<asp:Button id="Button4"
Text="Unknown Command Name"
CommandName="UnknownName"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>

 

<asp:Button id="Button5"
Text="Submit Unknown Command Argument"
CommandName="Submit"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>

<br /><br />

<asp:Label id="Message" runat="server"/>

</form>

</body>
</html>