ImageButton.OnCommand(CommandEventArgs) ImageButton.OnCommand(CommandEventArgs) ImageButton.OnCommand(CommandEventArgs) ImageButton.OnCommand(CommandEventArgs) Method

Определение

Вызывает событие Command и позволяет выполнить непосредственную обработку события Command.Raises the Command event and allows you to handle the Command event directly.

protected:
 virtual void OnCommand(System::Web::UI::WebControls::CommandEventArgs ^ e);
protected virtual void OnCommand (System.Web.UI.WebControls.CommandEventArgs e);
abstract member OnCommand : System.Web.UI.WebControls.CommandEventArgs -> unit
override this.OnCommand : System.Web.UI.WebControls.CommandEventArgs -> unit
Protected Overridable Sub OnCommand (e As CommandEventArgs)

Параметры

e
CommandEventArgs CommandEventArgs CommandEventArgs CommandEventArgs

Объект CommandEventArgs, содержащий данные события.A CommandEventArgs that contains the event data.

Примеры

В следующем примере показано, как задать и запрограммировать обработчик для Command события, чтобы определить ImageButton , какой элемент управления щелкнули.The following example demonstrates how to specify and code a handler for the Command event to determine which ImageButton control is clicked.

Примечание

В следующем примере кода используется модель кода с одним файлом, и она может работать неправильно, если копировать их непосредственно в файл кода программной части.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением. aspx.This code sample must be copied into an empty text file that has an .aspx extension. Дополнительные сведения о модели кода веб-форм см. в разделе модель кода страницы веб-форм ASP.NET.For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

<%@ 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" && e.CommandArgument == "Ascending")
            Label1.Text = "You clicked the Sort Ascending Button";
         else
            Label1.Text = "You clicked the Sort Descending 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 Ascending"
           ImageUrl="images/pict.jpg"
           OnCommand="ImageButton_Command"
           CommandName="Sort"
           CommandArgument="Ascending"/>

      <asp:ImageButton id="imagebutton2" runat="server"
           AlternateText="Sort Descending"
           ImageUrl="image/pict2.jpg"
           OnCommand="ImageButton_Command"
           CommandName="Sort"
           CommandArgument="Descending"/>

      <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") And (e.CommandArgument = "Ascending") Then
            Label1.Text = "You clicked the Sort Ascending Button"
         Else
            Label1.Text = "You clicked the Sort Descending 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 Ascending"
           ImageUrl="images/pict.jpg"
           OnCommand="ImageButton_Command"
           CommandName="Sort"
           CommandArgument="Ascending"/>

      <asp:ImageButton id="imagebutton2" runat="server"
           AlternateText="Sort Descending"
           ImageUrl="images/pict2.jpg"
           OnCommand="ImageButton_Command"
           CommandName="Sort"
           CommandArgument="Descending"/>

      <br /><br />
    
      <asp:label id="Label1" runat="server"/>

   </form>

</body>
</html>

Комментарии

Событие возникает при щелчке ImageButtonэлементауправления Command .The Command event is raised when the ImageButton control is clicked. Обработчик событий используется, чтобы ImageButton заставить элемент управления вести себя как кнопку командной строки. OnCommandThe OnCommand event handler is used to make the ImageButton control behave like a Command button. Имя команды может быть связано с элементом управления с помощью CommandName свойства.A command name can be associated with the control by using the CommandName property. Это позволяет размещать ImageButton на веб-странице несколько элементов управления.This allows multiple ImageButton controls to be placed on the Web page. Значение этого свойства затем может быть определено в OnCommand обработчике событий программным образом для определения соответствующего действия, выполняемого при щелчке по каждому ImageButton элементу управления.The value in this property can then be programmatically identified in the OnCommand event handler to determine the appropriate action to perform when each ImageButton control is clicked. CommandArgument Свойство также можно использовать для передачи дополнительных сведений о команде, например для указания порядка по возрастанию.The CommandArgument property can also be used to pass additional information about the command, such as specifying ascending order.

Примечание

Событие вызывается через иерархию элементов управления в форме BubbleEvent. CommandThe Command event is raised through the control hierarchy in the form of the BubbleEvent.

При возникновении события через делегат вызывается обработчик события.Raising an event invokes the event handler through a delegate. Дополнительные сведения см. в разделе Практическое руководство. Использование событий в приложениивеб-форм.For more information, see How to: Consume Events in a Web Forms Application.

Метод OnCommand также позволяет производным классам обрабатывать событие, не присоединяя делегат.The OnCommand method also allows derived classes to handle the event without attaching a delegate. Это предпочтительная методика обработки событий в производном классе.This is the preferred technique for handling the event in a derived class.

Примечания для тех, кто наследует этот метод

При переопределении метода OnCommand(CommandEventArgs) в производном классе нужно убедиться, что вызывается метод OnCommand(CommandEventArgs) базового класса, чтобы зарегистрированные делегаты получили событие.When overriding OnCommand(CommandEventArgs) in a derived class, be sure to call the base class's OnCommand(CommandEventArgs) method so that registered delegates receive the event.

Применяется к

Дополнительно