LinkButton.CommandName-Eigenschaft

Artikel
08/20/2007

Ruft den Befehlsnamen ab, der dem LinkButton-Steuerelement zugeordnet ist, oder legt diesen fest. Dieser Wert wird zusammen mit der CommandArgument-Eigenschaft an den Command-Ereignishandler übergeben.

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 LinkButton
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 des LinkButton-Steuerelements. Der Standardwert ist String.Empty.

Hinweise

Wenn sich auf einer Webseite mehrere LinkButton-Steuerelemente befinden, kann mithilfe der CommandName-Eigenschaft der Befehlsname angegeben oder bestimmt werden, der dem LinkButton-Steuerelement zugeordnet ist, auf das geklickt wird. Sie können die CommandName-Eigenschaft auf eine beliebige Zeichenfolge festlegen, die den auszuführenden Befehl angibt. Anschließend können Sie den Befehlsnamen des LinkButton-Steuerelements programmgesteuert ermitteln und die entsprechenden Aktionen ausführen.

Weitere Informationen über den Befehl, z. B. die Sortierreihenfolge Ascending, können mithilfe der CommandArgument-Eigenschaft angegeben 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 ein Befehlsname für ein LinkButton-Steuerelement angegeben wird.

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>

   <script language="VB" runat="server">
     
      Sub LinkButton_Command(sender As Object, e As CommandEventArgs) 
         Label1.Text = "You chose: " & e.CommandName & " Item " & _
            e.CommandArgument
      End Sub
 
   </script>
 
</head>
<body>
 
   <form runat=server>
 
      <h3>LinkButton Command Event Example</h3>
  
      <asp:LinkButton id="LinkButton1" 
           Text="Order Item 10001"
           CommandName="Order" 
           CommandArgument="10001" 
           OnCommand="LinkButton_Command" 
           runat="server"/>
 
      <br>
  
      <asp:LinkButton id="LinkButton2" 
           Text="Order Item 10002"
           CommandName="Order" 
           CommandArgument="10002" 
           OnCommand="LinkButton_Command" 
           Runat="server"/>
 
      <br>
      <p>
 
      <asp:Label id="Label1" runat="server"/>
 
   </form>

</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>

   <script language="C#" runat="server">
     
      void LinkButton_Command(Object sender, CommandEventArgs e) 
      {
         Label1.Text = "You chose: " + e.CommandName + " Item " + e.CommandArgument;
      }
 
   </script>
 
</head>
<body>
 
   <form runat=server>
 
      <h3>LinkButton Command Event Example</h3>
  
      <asp:LinkButton id="LinkButton1" 
           Text="Order Item 10001"
           CommandName="Order" 
           CommandArgument="10001" 
           OnCommand="LinkButton_Command" 
           runat="server"/>
 
      <br>
  
      <asp:LinkButton id="LinkButton2" 
           Text="Order Item 10002"
           CommandName="Order" 
           CommandArgument="10002" 
           OnCommand="LinkButton_Command" 
           Runat="server"/>
 
      <br>
      <p>
 
      <asp:Label id="Label1" runat="server"/>
 
   </form>

</body>
</html>

<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>

   <script language="JSCRIPT" runat="server">
     
      function LinkButton_Command(sender : Object, e : CommandEventArgs){
         Label1.Text = "You chose: " + e.CommandName + " Item " + e.CommandArgument
      }
 
   </script>
 
</head>
<body>
 
   <form runat=server>
 
      <h3>LinkButton Command Event Example</h3>
  
      <asp:LinkButton id="LinkButton1" 
           Text="Order Item 10001"
           CommandName="Order" 
           CommandArgument="10001" 
           OnCommand="LinkButton_Command" 
           runat="server"/>
 
      <br>
  
      <asp:LinkButton id="LinkButton2" 
           Text="Order Item 10002"
           CommandName="Order" 
           CommandArgument="10002" 
           OnCommand="LinkButton_Command" 
           Runat="server"/>
 
      <br>
      <p>
 
      <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

LinkButton-Klasse
LinkButton-Member
System.Web.UI.WebControls-Namespace
Command
OnCommand
LinkButton.CommandArgument-Eigenschaft

Weitere Ressourcen

Button-Webserver-Steuerelemente

Freigeben über