ImageButton.CommandName Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Befehlsnamen ab, der dem ImageButton-Steuerelement zugeordnet ist, oder legt diesen fest.
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
Eigenschaftswert
Der Befehlsname, der dem ImageButton-Steuerelement zugeordnet ist. Der Standardwert ist Empty.
Implementiert
- Attribute
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie die CommandName -Eigenschaft verwenden, um einem Steuerelement einen ImageButton Befehlsnamen zuzuordnen.
Hinweis
Das folgende Codebeispiel verwendet das Einzeldateicodemodell und funktioniert möglicherweise nicht ordnungsgemäß, 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 ASP.NET Web Forms-Seitencodemodell.
<%@ 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>
Hinweise
Verwenden Sie diese Eigenschaft, um den Befehl anzugeben, der ausgeführt werden soll, wenn auf das ImageButton Steuerelement geklickt wird, z Sort
. B. , Cancel
oder Edit
. Dadurch können mehrere ImageButton Steuerelemente auf derselben Webseite platziert werden. Der Wert in dieser Eigenschaft kann dann programmgesteuert im OnCommand Ereignishandler identifiziert werden, um die geeignete Aktion zu bestimmen, die ausgeführt werden soll, wenn auf jedes ImageButton Steuerelement geklickt wird.
Zusätzliche Informationen zum Befehl, z. B. die Angabe aufsteigender Sortierreihenfolge, können mithilfe der CommandArgument -Eigenschaft eingeschlossen werden.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.