LinkButton.OnCommand(CommandEventArgs) Метод

Определение

Вызывает событие Command элемента управления LinkButton.Raises the Command event of the LinkButton control.

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, содержащий данные события.A CommandEventArgs that contains the event data.

Примеры

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

<%@ 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>LinkButton Command Event Example</title>
<script language="C#" runat="server">
     
      void LinkButton_Command(Object sender, CommandEventArgs e) 
      {
         Label1.Text = "You chose: " + e.CommandName + " Item " + e.CommandArgument;
      }
 
   </script>
 
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>LinkButton Command Event Example</h3>
  
      <asp:LinkButton id="LinkButton1" 
           Text="Order Item 10001"
           CommandName="Order" 
           CommandArgument="10001" 
           OnCommand="LinkButton_Command" 
           runat="server"/>
 
      <br />
  
      <asp:LinkButton id="LinkButton2" 
           Text="Order Item 10002"
           CommandName="Order" 
           CommandArgument="10002" 
           OnCommand="LinkButton_Command" 
           Runat="server"/>
 
      <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>LinkButton Command Event Example</title>
<script language="VB" runat="server">
     
      Sub LinkButton_Command(sender As Object, e As CommandEventArgs) 
         Label1.Text = "You chose: " & e.CommandName & " Item " & _
            e.CommandArgument
      End Sub
 
   </script>
 
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>LinkButton Command Event Example</h3>
  
      <asp:LinkButton id="LinkButton1" 
           Text="Order Item 10001"
           CommandName="Order" 
           CommandArgument="10001" 
           OnCommand="LinkButton_Command" 
           runat="server"/>
 
      <br />
  
      <asp:LinkButton id="LinkButton2" 
           Text="Order Item 10002"
           CommandName="Order" 
           CommandArgument="10002" 
           OnCommand="LinkButton_Command" 
           Runat="server"/>
 
      <br />
      <br />
 
      <asp:Label id="Label1" runat="server"/>
 
   </form>

</body>
</html>

Комментарии

Событие Command возникает при щелчке элемента управления LinkButton.The Command event is raised when the LinkButton control is clicked. Это событие часто используется, когда имя команды, например Sort, связано с элементом управления LinkButton.This event is commonly used when a command name, such as Sort, is associated with the LinkButton control. Это позволяет создать несколько элементов управления LinkButton на веб-странице и программно определить, какой элемент управления LinkButton щелкнул.This allows you to create multiple LinkButton controls on a Web page and programmatically determine which LinkButton control is clicked.

Примечание

Событие Command возникает через иерархию элементов управления в форме BubbleEvent.The 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 Handling and Raising Events.

Метод 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.

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

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