ImageButton.CommandName Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает имя команды, связанное с элементом управления ImageButton.
public:
property System::String ^ CommandName { System::String ^ get(); void set(System::String ^ value); };public string CommandName { get; set; }[System.Web.UI.Themeable(false)]
public string CommandName { get; set; }member this.CommandName : string with get, set[<System.Web.UI.Themeable(false)>]
member this.CommandName : string with get, setPublic Property CommandName As StringЗначение свойства
Имя команды, связанное с элементом управления ImageButton. Значение по умолчанию — Empty.
Реализации
- Атрибуты
Примеры
В следующем примере показано, как использовать CommandName свойство для связывания имени команды с элементом ImageButton управления .
Примечание
В следующем примере кода используется однофайловая модель кода, и при копировании непосредственно в файл кода программной части может работать неправильно. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением .aspx. Дополнительные сведения о модели кода веб-форм см. в разделе модель кода веб-форм ASP.NET.
<%@ 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 xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ImageButton CommandName Sample</title>
<script language="C#" runat="server">
void ImageButton_Command(object sender, CommandEventArgs e)
{
if (e.CommandName == "Sort")
Label1.Text = "You clicked the Sort Button";
else
Label1.Text = "You clicked the Edit Button";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageButton CommandName Sample</h3>
Click an image.<br /><br />
<asp:ImageButton id="imagebutton1" runat="server"
AlternateText="Sort"
ImageUrl="images/pict1.jpg"
OnCommand="ImageButton_Command"
CommandName="Sort"/>
<asp:ImageButton id="imagebutton2" runat="server"
AlternateText="Edit"
ImageUrl="images/pict2.jpg"
OnCommand="ImageButton_Command"
CommandName="Edit"/>
<br /><br />
<asp:label id="Label1" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ImageButton CommandName Sample</title>
<script language="VB" runat="server">
Sub ImageButton_Command(sender As Object, e As CommandEventArgs)
If e.CommandName = "Sort" Then
Label1.Text = "You clicked the Sort Button"
Else
Label1.Text = "You clicked the Edit Button"
End If
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageButton CommandName Sample</h3>
Click an image.<br /><br />
<asp:ImageButton id="imagebutton1" runat="server"
AlternateText="Sort"
ImageUrl="images/pict1.jpg"
OnCommand="ImageButton_Command"
CommandName="Sort"/>
<asp:ImageButton id="imagebutton2" runat="server"
AlternateText="Edit"
ImageUrl="images/pict2.jpg"
OnCommand="ImageButton_Command"
CommandName="Edit"/>
<br /><br />
<asp:label id="Label1" runat="server"/>
</form>
</body>
</html>
Комментарии
Используйте это свойство, чтобы указать команду, выполняемую при ImageButton щелчке элемента управления, например Sort, Cancelили Edit. Это позволяет размещать несколько ImageButton элементов управления на одной веб-странице. Затем значение в этом свойстве можно программно определить в обработчике OnCommand событий, чтобы определить соответствующее действие, выполняемое при щелчке по каждому ImageButton элементу управления.
Дополнительные сведения о команде, например указание порядка сортировки по возрастанию, можно включить с помощью CommandArgument свойства .
Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в разделе ThemeableAttribute и ASP.NET темы и обложки.
