LinkButton.OnCommand(CommandEventArgs) Método

Definição

Aciona o evento Command do controle LinkButton.

protected virtual void OnCommand (System.Web.UI.WebControls.CommandEventArgs e);

Parâmetros

e
CommandEventArgs

Um CommandEventArgs que contém os dados do evento.

Exemplos

O exemplo a seguir demonstra como especificar e codificar um manipulador para o Command evento para exibir qual LinkButton controle é clicado.

<%@ 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>

Comentários

O Command evento é gerado quando o LinkButton controle é clicado. Esse evento geralmente é usado quando um nome de comando, como Sort, é associado ao LinkButton controle . Isso permite que você crie vários LinkButton controles em uma página da Web e determine programaticamente qual LinkButton controle é clicado.

Observação

O Command evento é gerado por meio da hierarquia de controle na forma do BubbleEvent.

A geração de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações, consulte Manipulando e gerando eventos.

O OnCommand método também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.

Notas aos Herdeiros

Ao substituir OnCommand(CommandEventArgs) em uma classe derivada, chame o método da OnCommand(CommandEventArgs) classe base para que os delegados registrados recebam o evento.

Aplica-se a

Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também