ImageButton.OnCommand(CommandEventArgs) Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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, das die Ereignisdaten enthält.

Beispiele

Im folgenden Beispiel wird 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 Einzeldateicodemodell verwendet. Es funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit der Erweiterung .aspx kopiert werden. Weitere Informationen zum Web Forms Codemodell finden Sie unter ASP.NET Web Forms Seitencodemodell.

<%@ 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, damit sich das ImageButton Steuerelement wie eine Befehlsschaltfläche verhält. 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. das Angeben der aufsteigenden Reihenfolge.

Hinweis

Das Command -Ereignis wird über die Steuerelementhierarchie in Form von BubbleEventausgelöst.

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter How to: Consume Events in a Web Forms Application.

Mit der OnCommand-Methode können auch abgeleitete Klassen das Ereignis ohne Anfügen eines Delegaten behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Vererber

Wenn Sie OnCommand(CommandEventArgs) in einer abgeleiteten Klasse überschreiben, müssen Sie die OnCommand(CommandEventArgs)-Methode der Basisklasse aufrufen, damit registrierte Delegaten das Ereignis empfangen.

Gilt für: