Sdílet prostřednictvím

ImageButton.OnCommand(CommandEventArgs) Metoda

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Command Vyvolá událost a umožňuje zpracovat Command událost přímo.

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)

Parametry

e
CommandEventArgs

A CommandEventArgs obsahující data události.

Příklady

Následující příklad ukazuje, jak určit a kód obslužné rutiny Command události určit, který ImageButton ovládací prvek je kliknut.

Poznámka:

Následující ukázka kódu používá model kódu s jedním souborem a při kopírování přímo do souboru s kódem nemusí správně fungovat. Tento vzorový kód musí být zkopírován do prázdného textového souboru, který má příponu .aspx. Další informace o modelu kódu webového formuláře najdete v tématu ASP.NET model kódu stránky webového formuláře.

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

Poznámky

Událost Command se vyvolá po kliknutí na ImageButton ovládací prvek. Obslužná rutina OnCommand události se používá k tomu, aby se ImageButton ovládací prvek choval jako příkazové tlačítko. Název příkazu lze přidružit k ovládacímu prvku pomocí CommandName vlastnosti. To umožňuje umístění více ImageButton ovládacích prvků na webovou stránku. Hodnota v této vlastnosti lze poté programově identifikovat v OnCommand obslužné rutině události určit odpovídající akci, která se má provést při každém kliknutí na ovládací ImageButton prvek. Vlastnost CommandArgument lze také použít k předání dalších informací o příkazu, například zadání vzestupného pořadí.

Poznámka:

Událost Command je vyvolána prostřednictvím řídicí hierarchie ve formě BubbleEvent.

Vyvolání události vyvolá obslužnou rutinu události prostřednictvím delegáta. Další informace naleznete v tématu Postupy: Využívání událostí v aplikaci Webových formulářů.

Metoda OnCommand také umožňuje odvozené třídy zpracovat událost bez připojení delegáta. Toto je upřednostňovaná technika pro zpracování události v odvozené třídě.

Poznámky pro dědice

Při přepsání OnCommand(CommandEventArgs) v odvozené třídě nezapomeňte volat metodu základní třídy OnCommand(CommandEventArgs) , aby zaregistrovaní delegáti obdrželi událost.

Platí pro

Viz také