CommandArgument Eigenschaft
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

ImageButton.CommandArgument-Eigenschaft

Ruft ein optionales Argument ab, das zusätzliche Informationen zur CommandName-Eigenschaft bereitstellt, oder legt dieses fest.

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

[BindableAttribute(true)]
[ThemeableAttribute(false)]
public string CommandArgument { get; set; }
<asp:ImageButton CommandArgument="String" />

Eigenschaftswert

Typ: System.String
Ein optionales Argument, das die CommandName-Eigenschaft ergänzt.

Implements

IButtonControl.CommandArgument

In manchen Fällen sind mehrere ImageButton-Steuerelemente miteinander verknüpft und verwenden für die CommandName-Eigenschaft denselben Wert (z. B. Sort). Ergänzen Sie mit dieser Eigenschaft die CommandName-Eigenschaft mit zusätzlichen Informationen über den auszuführenden Befehl, z. B. Ascending. Die Werte der CommandName-Eigenschaft und der CommandArgument-Eigenschaft werden i. d. R. im OnCommand-Ereignishandler verwendet, um die beim Klicken auf das ImageButton-Steuerelement auszuführende Aktion zu bestimmen.

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

Das folgende Beispiel veranschaulicht, wie mithilfe der CommandArgument-Eigenschaft einem ImageButton-Steuerelement ein Befehlsargument zugeordnet wird.

HinweisHinweis

Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine Code-Behind-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 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" && 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>



.NET Framework

Unterstützt in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2016 Microsoft