Freigeben über

ImageButton.OnCommand(CommandEventArgs) Methode

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Löst das Command Ereignis aus und ermöglicht es Ihnen, das Command Ereignis direkt zu behandeln.

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)

Parameter

e
CommandEventArgs

Ein CommandEventArgs Objekt, das die Ereignisdaten enthält.

Beispiele

Das folgende Beispiel veranschaulicht, wie ein Handler für das Command Ereignis angegeben und codiert wird, um zu bestimmen, auf welches ImageButton Steuerelement geklickt wird.

Hinweis

Im folgenden Codebeispiel wird das Codemodell mit einer Datei verwendet und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei kopiert werden, die über eine .aspx Erweiterung verfügt. Weitere Informationen zum Web Forms-Codemodell finden Sie unter 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>

Hinweise

Das Command Ereignis wird ausgelöst, wenn auf das ImageButton Steuerelement geklickt wird. Der OnCommand Ereignishandler wird verwendet, um das ImageButton Steuerelement wie eine Befehlsschaltfläche zu verhalten. Ein Befehlsname kann dem Steuerelement mithilfe der CommandName Eigenschaft zugeordnet werden. Dadurch können mehrere ImageButton Steuerelemente auf der Webseite platziert werden. Der Wert in dieser Eigenschaft kann dann programmgesteuert im OnCommand Ereignishandler identifiziert werden, um die entsprechende Aktion zu bestimmen, die ausgeführt werden soll, wenn auf jedes ImageButton Steuerelement geklickt wird. Die CommandArgument Eigenschaft kann auch verwendet werden, um zusätzliche Informationen zum Befehl zu übergeben, z. B. zum Angeben aufsteigender Reihenfolge.

Hinweis

Das Command Ereignis wird über die Steuerelementhierarchie in Form der BubbleEvent.

Das Auslösen eines Ereignisses ruft den Ereignishandler über einen Delegaten auf. Weitere Informationen finden Sie unter How to: Consume Events in a Web Forms Application.

Mit der OnCommand Methode können abgeleitete Klassen auch das Ereignis behandeln, ohne einen Delegaten anzufügen. Dies ist die bevorzugte Technik für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Vererber

Achten Sie beim Überschreiben OnCommand(CommandEventArgs) in einer abgeleiteten Klasse darauf, die Methode der Basisklasse OnCommand(CommandEventArgs) aufzurufen, damit registrierte Stellvertretungen das Ereignis empfangen.

Gilt für:

Weitere Informationen