LinkButton.CommandArgument-Eigenschaft

Artikel
08/20/2007

Ruft ein zusammen mit der zugeordneten CommandName-Eigenschaft an den Command-Ereignishandler übergebenes optionales Argument ab oder legt dieses fest.

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

Syntax

'Declaration
<ThemeableAttribute(False)> _
<BindableAttribute(True)> _
Public Property CommandArgument As String
'Usage
Dim instance As LinkButton
Dim value As String

value = instance.CommandArgument

instance.CommandArgument = value

[ThemeableAttribute(false)] 
[BindableAttribute(true)] 
public string CommandArgument { get; set; }

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

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

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

public final function get CommandArgument () : String

public final function set CommandArgument (value : String)

Eigenschaftenwert

Ein zusammen mit der zugeordneten CommandName-Eigenschaft an den Command-Ereignishandler übergebenes optionales Argument. Der Standardwert ist String.Empty.

Hinweise

Verwenden Sie die CommandArgument-Eigenschaft, um ein Argument anzugeben, das die CommandName-Eigenschaft ergänzt.

Hinweis

Die CommandArgument-Eigenschaft wird i. d. R. nur verwendet, wenn die CommandName-Eigenschaft festgelegt ist.

Die CommandArgument-Eigenschaft ergänzt die CommandName-Eigenschaft, sodass Sie beliebige zusätzliche Informationen über den auszuführenden Befehl bereitstellen können. Sie können z. B. die CommandName-Eigenschaft auf Sort und die CommandArgument-Eigenschaft auf Ascending festlegen, um einen Befehl zum Sortieren in aufsteigender Reihenfolge anzugeben.

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 CommandArgument-Eigenschaft ein optionales Argument zum Ergänzen des Befehlsnamens eines LinkButton-Steuerelements 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
CommandName

Weitere Ressourcen

Button-Webserver-Steuerelemente

Freigeben über