Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

ImageButton.CommandName-Eigenschaft

 

Veröffentlicht: Oktober 2016

Ruft ab oder legt die zugeordneten Befehlsnamen der ImageButton Steuerelement.

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

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

Eigenschaftswert

Type: System.String

Der Name des Befehls zugeordneten der ImageButton Steuerelement. Der Standardwert ist String.Empty.

Verwenden Sie diese Eigenschaft zur Angabe des Befehls beim Ausführen der ImageButton -Steuerelement geklickt wird, z. B. Sort, Cancel, oder Edit. Dadurch können mehrere ImageButton Steuerelemente auf der gleichen Webseite platziert werden sollen. Der Wert in dieser Eigenschaft kann dann programmgesteuert im ermittelt werden die OnCommand -Ereignishandler so bestimmen die entsprechende Aktion ausgeführt jedes ImageButton -Steuerelement geklickt wird.

Zusätzliche Informationen über den Befehl, z. B. aufsteigende Sortierreihenfolge kann enthalten sein, mit der CommandArgument Eigenschaft.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET Themes and Skins.

Im folgenden Beispiel wird veranschaulicht, wie die CommandName Eigenschaft, um einen Befehlsnamen mit Zuordnen einer ImageButton Steuerelement.

System_CAPS_noteHinweis

Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet und kann nicht ordnungsgemäß funktionieren, wenn Sie direkt in eine Code-Behind-Datei kopiert. Dieses Codebeispiel muss in eine leere Textdatei kopiert werden, die einer ASPX-Erweiterung. Weitere Informationen über das Web Forms-Codemodell finden Sie unter ASP.NET Web Forms Page Code Model.

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

.NET Framework
Verfügbar seit 1.1
Zurück zum Anfang
Anzeigen: