LinkButton.CommandArgument LinkButton.CommandArgument LinkButton.CommandArgument LinkButton.CommandArgument Property

定義

関連付けられている Command プロパティと共に CommandName イベント ハンドラーに渡されるオプション引数を取得または設定します。Gets or sets an optional argument passed to the Command event handler along with the associated CommandName property.

public:
 property System::String ^ CommandArgument { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public string CommandArgument { get; set; }
member this.CommandArgument : string with get, set
Public Property CommandArgument As String

プロパティ値

関連付けられている Command プロパティと共に CommandName イベント ハンドラーに渡されるオプション引数。An optional argument passed to the Command event handler along with the associated CommandName property. 既定値は Empty です。The default value is Empty.

実装

次の例では、CommandArgument プロパティを使用して、LinkButton コントロールのコマンド名を補完するオプションの引数を指定する方法を示します。The following example demonstrates how to use the CommandArgument property to specify an optional argument that complements the command name for a LinkButton control.

<%@ 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>LinkButton Command Event Example</title>
<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 id="form1" 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 />
      <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>LinkButton Command Event Example</title>
<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 id="form1" 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 />
      <br />
 
      <asp:Label id="Label1" runat="server"/>
 
   </form>

</body>
</html>

注釈

@No__t-0 プロパティを使用して、CommandName プロパティを補完する引数を指定します。Use the CommandArgument property to specify an argument that complements the CommandName property.

注意

@No__t-0 プロパティは、通常、CommandName プロパティが設定されている場合にのみ使用されます。The CommandArgument property is typically only used when the CommandName property is set.

@No__t-0 プロパティは、実行するコマンドに関する追加情報を提供できるようにすることで、CommandName プロパティを補完します。The CommandArgument property complements the CommandName property by allowing you to provide any additional information about the command to perform. たとえば、CommandName プロパティを Sort に設定し、CommandArgument プロパティを Ascending に設定して、昇順で並べ替えるコマンドを指定できます。For example, you can set the CommandName property to Sort and set the CommandArgument property to Ascending to specify a command to sort in ascending order.

このプロパティは、テーマまたはスタイル シート テーマによって設定することはできません。This property cannot be set by themes or style sheet themes. 詳細については、「ThemeableAttribute and ASP.NET theme And スキン」を参照してください。For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

適用対象

こちらもご覧ください