ImageButton.CommandName ImageButton.CommandName ImageButton.CommandName ImageButton.CommandName Property

定義

ImageButton コントロールと関連付けられたコマンド名を取得または設定します。Gets or sets the command name associated with the ImageButton control.

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

プロパティ値

ImageButton コントロールに関連付けられたコマンド名。The command name associated with the ImageButton control. 既定値は Empty です。The default value is Empty.

実装

次の例は、 CommandNameプロパティを使用しImageButtonてコマンド名をコントロールに関連付ける方法を示しています。The following example demonstrates how to use the CommandName property to associate a command name with an ImageButton control.

注意

次のコードサンプルでは、単一ファイルのコードモデルを使用して、分離コードファイルに直接コピーした場合、正しく機能しない可能性があります。The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. このコードサンプルは、.aspx 拡張子を持つ空のテキストファイルにコピーする必要があります。This code sample must be copied into an empty text file that has an .aspx extension. Web フォームコードモデルの詳細については、「 ASP.NET Web Forms Page Code model」を参照してください。For more information on the Web Forms code model, see ASP.NET Web Forms 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")
            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>

注釈

このプロパティImageButtonを使用してSort、、 CancelEditなどのコントロールがクリックされたときに実行するコマンドを指定します。Use this property to specify the command to perform when the ImageButton control is clicked, such as Sort, Cancel, or Edit. これによりImageButton 、複数のコントロールを同じ Web ページに配置できます。This allows multiple ImageButton controls to be placed on the same Web page. このプロパティの値は、各OnCommand ImageButtonコントロールがクリックされたときに実行する適切なアクションを決定するために、イベントハンドラーでプログラムによって識別されます。The value in this property can then be programmatically identified in the OnCommand event handler to determine the appropriate action to perform when each ImageButton control is clicked.

昇順の並べ替え順序を指定するなど、コマンドに関する補足情報は、 CommandArgumentプロパティを使用して含めることができます。Supplemental information about the command, such as specifying ascending sort order, can be included by using the CommandArgument property.

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

適用対象

こちらもご覧ください