ImageButton.OnCommand-Methode

Artikel
08/20/2007

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

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

Syntax

'Declaration
Protected Overridable Sub OnCommand ( _
    e As CommandEventArgs _
)
'Usage
Dim e As CommandEventArgs

Me.OnCommand(e)

protected virtual void OnCommand (
    CommandEventArgs e
)

protected:
virtual void OnCommand (
    CommandEventArgs^ e
)

protected void OnCommand (
    CommandEventArgs e
)

protected function OnCommand (
    e : CommandEventArgs
)

Parameter

e
Eine Instanz der CommandEventArgs-Klasse, die die Ereignisdaten enthält.

Hinweise

Das Command-Ereignis wird durch Klicken auf das ImageButton-Steuerelement ausgelöst. Mithilfe des OnCommand-Ereignishandlers kann festgelegt werden, dass das ImageButton-Steuerelement wie eine Befehlsschaltfläche funktionieren soll. Unter Verwendung der CommandName-Eigenschaft kann dem Steuerelement ein Befehlsname zugeordnet werden. Auf diese Weise ist es möglich, mehrere ImageButton-Steuerelemente auf der Webseite zu platzieren. Der Wert in dieser Eigenschaft kann dann programmgesteuert im OnCommand-Ereignishandler bezeichnet werden, um die Aktion zu bestimmen, die beim Klicken auf das jeweilige ImageButton-Steuerelement ausgeführt werden soll. Mit der CommandArgument-Eigenschaft können außerdem zusätzliche Informationen über den Befehl übergeben werden, z. B. aufsteigende Sortierung.

Hinweis

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

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Gewusst wie: Verarbeiten von Ereignissen in einer Web Forms-Anwendung.

Die OnCommand-Methode ermöglicht es auch abgeleiteten Klassen, das Ereignis ohne Anfügen eines Delegaten zu behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Erben Wenn Sie OnCommand in einer abgeleiteten Klasse überschreiben, müssen Sie die OnCommand-Methode der Basisklasse aufrufen, sodass registrierte Delegaten das Ereignis empfangen.

Beispiel

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

Hinweis

Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.

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

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

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

   <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 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="JScript" AutoEventWireup="True" %>
<html>
<head>

   <script language="JSCRIPT" runat="server">

      function ImageButton_Command(sender : Object, e : CommandEventArgs){
         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 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>

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

ImageButton-Klasse
ImageButton-Member
System.Web.UI.WebControls-Namespace
Command
CommandEventArgs-Klasse

Weitere Ressourcen

Deklarative Syntax des ImageButton-Webserversteuerelements
Übersicht über die Button-Webserversteuerelemente
Gewusst wie: Verarbeiten von Ereignissen in einer Web Forms-Anwendung

Freigeben über