Button Web サーバー コントロールの宣言構文

更新 : 2007 年 11 月

Web フォーム ページにプッシュ ボタン コントロールを表示します。

<asp:Button
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CommandArgument="string"
    CommandName="string"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnClick="Click event handler"
    OnClientClick="string"
    OnCommand="Command event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PostBackUrl="uri"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    ToolTip="string"
    UseSubmitBehavior="True|False"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

解説

Button コントロールを使用すると、Web フォーム ページにプッシュ ボタンを作成できます。submit ボタンまたは command ボタンの、2 種類のボタンを作成できます。

既定では、Button コントロールは submit ボタンです。submit ボタンには関連付けられているコマンド名 (CommandName プロパティで指定) がなく、その機能は単に Web ページをサーバーにポストバックするだけです。Click イベントのイベント ハンドラを作成して、submit ボタンがクリックされたときに実行するアクションをプログラムで制御できます。

command ボタンには、CommandName プロパティを設定することによってコマンド名 (Sort など) を関連付けることができます。これにより、Web フォーム ページ上に複数の Button コントロールを作成し、どの Button コントロールがクリックされたのかを Command イベントのイベント ハンドラでプログラムによって判断できます。command ボタンで CommandArgument プロパティを使用して、Ascending などの実行するコマンドに関する追加情報を指定することもできます。Command イベントのイベント ハンドラを作成して、command ボタンがクリックされたときに実行するアクションをプログラムで制御できます。

Command ボタンは、アクションを親コントロールに通知するために、テンプレート コントロールで頻繁に使用されます。たとえば、DataList での選択や FormView でのモードの変更などのアクションです。

既定では、Button コントロールがクリックされたときに、ページの検証が行われます。ページ検証では、ページ上の検証コントロールに関連付けられている入力コントロールが、その検証コントロールによって指定されている入力規則を満たしているかどうかが確認されます。reset ボタンなど、この動作を無効にする必要がある Button コントロールがある場合、CausesValidation プロパティを false に設定します。

メモ :
<asp:Button> 要素には内容が含まれないため、個別に終了タグを使用する代わりに /> でタグを閉じることができます。

Button コントロールに表示するキャプションを指定するには、Text プロパティを設定します。

Button コントロールのプロパティとイベントの詳細については、Button のドキュメントを参照してください。

使用例

.aspx ファイルで submit ボタン コントロールを宣言する方法を次の例に示します。

<asp:Button id="SubmitButton"
     Text="Submit"
     CommandName="Submit"
     OnCommand="CommandBtn_Click"
     runat="server"  />

<asp:Button id="SubmitButton"
     Text="Submit"
     CommandName="Submit"
     OnCommand="CommandBtn_Click"
     runat="server"/>

.aspx ファイルで command ボタン コントロールを宣言する方法を次の例に示します。

<asp:Button id="SortAscendingButton"
     Text="Sort Ascending"
     CommandName="Sort"
     CommandArgument="Ascending"
     OnCommand="CommandBtn_Click"
     runat="server"/>

<asp:Button id="SortAscendingButton"
     Text="Sort Ascending"
     CommandName="Sort"
     CommandArgument="Ascending"
     OnCommand="CommandBtn_Click"
     runat="server"/>

ボタン クリックを取得し、CommandName プロパティと CommandArgument プロパティでボタンから渡された情報を表示するイベント処理メソッドを次の例に示します。

Sub CommandBtn_Click(ByVal sender As Object, ByVal e As CommandEventArgs)
    Message.Text = "You clicked the " & e.CommandName & _
                   " - " & e.CommandArgument & " button."
End Sub

void CommandBtn_Click(Object sender, CommandEventArgs e)
{
    Message.Text = "You clicked the " + e.CommandName +
                   " - " + e.CommandArgument + " button.";
}

参照

参照

Button

その他の技術情報

Web サーバー コントロール構文