ImageButton.CommandName Tulajdonság

Definíció

Névtér:
System.Web.UI.WebControls
Szerelvény:
System.Web.dll

Lekéri vagy beállítja a vezérlőhöz ImageButton társított parancsnevet.

public:
 property System::String ^ CommandName { System::String ^ get(); void set(System::String ^ value); };
public string CommandName { get; set; }
[System.Web.UI.Themeable(false)]
public string CommandName { get; set; }
member this.CommandName : string with get, set
[<System.Web.UI.Themeable(false)>]
member this.CommandName : string with get, set
Public Property CommandName As String

Tulajdonság értéke

String

A vezérlőhöz ImageButton társított parancsnév. Az alapértelmezett érték a Empty.

Megvalósítás

CommandName
Attribútumok
ThemeableAttribute

Példák

Az alábbi példa bemutatja, hogyan társíthat parancsnevet egy vezérlőelemhez a CommandName tulajdonság használatával ImageButton .

Note

Az alábbi kódminta az egyfájlos kódmodellt használja, és előfordulhat, hogy nem működik megfelelően, ha közvetlenül egy kód mögötti fájlba másolja. Ezt a kódmintát egy üres szövegfájlba kell másolni, amely .aspx kiterjesztéssel rendelkezik. A Webes űrlapok kódmodellről további információt a ASP.NET Web Forms Lapkódmodell című témakörben talál.

<%@ 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")
            Label1.Text = "You clicked the Sort Button";
         else
            Label1.Text = "You clicked the Edit 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"
           ImageUrl="images/pict1.jpg"
           OnCommand="ImageButton_Command"
           CommandName="Sort"/>

      <asp:ImageButton id="imagebutton2" runat="server"
           AlternateText="Edit"
           ImageUrl="images/pict2.jpg"
           OnCommand="ImageButton_Command"
           CommandName="Edit"/>

      <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" Then
            Label1.Text = "You clicked the Sort Button"
         Else
            Label1.Text = "You clicked the Edit 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"
           ImageUrl="images/pict1.jpg"
           OnCommand="ImageButton_Command"
           CommandName="Sort"/>

      <asp:ImageButton id="imagebutton2" runat="server"
           AlternateText="Edit"
           ImageUrl="images/pict2.jpg"
           OnCommand="ImageButton_Command"
           CommandName="Edit"/>

      <br /><br />
    
      <asp:label id="Label1" runat="server"/>

   </form>

</body>
</html>

Megjegyzések

Ezzel a tulajdonságbal adhatja meg a vezérlő kattintásakor ImageButton végrehajtandó parancsot, például Sort: , Cancelvagy Edit. Így több ImageButton vezérlő is elhelyezhető ugyanazon a weblapon. A tulajdonság értéke ezután programozott módon azonosítható az OnCommand eseménykezelőben, hogy meghatározza az egyes ImageButton vezérlők kattintáskor végrehajtandó megfelelő műveletet.

A parancsra vonatkozó kiegészítő információk, például növekvő rendezési sorrend megadása, a CommandArgument tulajdonság használatával vehetők fel.

Ez a tulajdonság nem állítható be témák vagy stíluslaptémák szerint. További információ: ThemeableAttribute és ASP.NET Témák és bőrök.

A következőre érvényes:

Lásd még