ImageButton.CommandName-Eigenschaft

Artikel
08/20/2007

Ruft den Befehlsnamen ab, der dem ImageButton-Steuerelement zugeordnet ist, oder legt diesen fest.

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

Syntax

'Declaration
<ThemeableAttribute(False)> _
Public Property CommandName As String
'Usage
Dim instance As ImageButton
Dim value As String

value = instance.CommandName

instance.CommandName = value

[ThemeableAttribute(false)] 
public string CommandName { get; set; }

[ThemeableAttribute(false)] 
public:
virtual property String^ CommandName {
    String^ get () sealed;
    void set (String^ value) sealed;
}

/** @property */
public final String get_CommandName ()

/** @property */
public final void set_CommandName (String value)

public final function get CommandName () : String

public final function set CommandName (value : String)

Eigenschaftenwert

Der Befehlsname, der dem ImageButton-Steuerelement zugeordnet ist. Der Standardwert ist String.Empty.

Hinweise

Mit dieser Eigenschaft können Sie den Befehl angeben, der ausgeführt werden soll, wenn auf das ImageButton-Steuerelement geklickt wird, z. B. Sort, Cancel oder Edit. Auf diese Weise ist es möglich, mehrere ImageButton-Steuerelemente auf derselben 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.

Ergänzende Informationen über den Befehl, z. B. das Angeben einer aufsteigenden Sortierreihenfolge, können mithilfe der CommandArgument-Eigenschaft einbezogen werden.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und Übersicht über ASP.NET-Designs und ASP.NET-Skins.

Beispiel

Das folgende Beispiel veranschaulicht, wie mithilfe der CommandName-Eigenschaft einem ImageButton-Steuerelement ein Befehlsname zugeordnet 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" Then
            Label1.Text = "You clicked the Sort Button"
         Else
            Label1.Text = "You clicked the Edit 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"
           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="C#" AutoEventWireup="True" %>
<html>
<head>

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

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

      function ImageButton_Command(sender : Object, e : CommandEventArgs){
         if(e.CommandName == "Sort")
            Label1.Text = "You clicked the Sort Button"
         else
            Label1.Text = "You clicked the Edit 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"
           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>

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
Button.CommandArgument-Eigenschaft
OnClick

Weitere Ressourcen

Deklarative Syntax des ImageButton-Webserversteuerelements
Übersicht über die Button-Webserversteuerelemente

Freigeben über