LinkButton.Command-Ereignis

Artikel
08/20/2007

Tritt auf, wenn auf das LinkButton-Steuerelement geklickt wird.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Event Command As CommandEventHandler
'Usage
Dim instance As LinkButton
Dim handler As CommandEventHandler

AddHandler instance.Command, handler

public event CommandEventHandler Command

public:
virtual event CommandEventHandler^ Command {
    void add (CommandEventHandler^ value) sealed;
    void remove (CommandEventHandler^ value) sealed;
}

/** @event */
public final void add_Command (CommandEventHandler value)

/** @event */
public final void remove_Command (CommandEventHandler value)

JScript unterstützt die Verwendung von Ereignissen, aber nicht die Deklaration von neuen Ereignissen.

Hinweise

Das Command-Ereignis wird durch Klicken auf das LinkButton-Steuerelement ausgelöst. Dieses Ereignis wird i. d. R. verwendet, wenn dem LinkButton-Steuerelement ein Befehlsname, z. B. Sort, zugeordnet ist. So können Sie auf einer Webseite mehrere LinkButton-Steuerelemente erstellen und programmgesteuert ermitteln, auf welches LinkButton-Steuerelement geklickt wurde.

Hinweis

Das Command-Ereignis wird durch die Steuerelementhierarchie im Formular von BubbleEvent ausgelöst.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln von Ereignissen.

Beispiel

Das folgende Beispiel veranschaulicht, wie für das Click-Ereignis ein Handler angegeben und codiert wird, um eine Meldung anzuzeigen, wenn auf das LinkButton-Steuerelement geklickt wird.

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>

   <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 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>
      <p>
 
      <asp:Label id="Label1" runat="server"/>
 
   </form>

</body>
</html>

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

   <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 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>
      <p>
 
      <asp:Label id="Label1" runat="server"/>
 
   </form>

</body>
</html>

<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>

   <script language="JSCRIPT" runat="server">
     
      function LinkButton_Command(sender : Object, e : CommandEventArgs){
         Label1.Text = "You chose: " + e.CommandName + " Item " + e.CommandArgument
      }
 
   </script>
 
</head>
<body>
 
   <form 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>
      <p>
 
      <asp:Label id="Label1" runat="server"/>
 
   </form>

</body>
</html>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

LinkButton-Klasse
LinkButton-Member
System.Web.UI.WebControls-Namespace
OnCommand
CommandEventHandler-Delegat

Weitere Ressourcen

Button-Webserver-Steuerelemente

Freigeben über