次の方法で共有

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

更新 : 2007 年 11 月

Web フォーム ページにハイパーリンク スタイル ボタンを作成します。

<asp:LinkButton
    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"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

解説

LinkButton コントロールを使用して、Web フォーム ページにハイパーリンク スタイル ボタンを作成できます。LinkButton コントロールに表示するテキストを指定するには、Text プロパティを設定するか、LinkButton コントロールの開始タグと終了タグの間にテキストを挿入します。送信ボタンまたはコマンド ボタンを作成できます。

1cd4z1zs.alert_note(ja-jp,VS.90).gifメモ :

LinkButton コントロールの外観は HyperLink コントロールと同じですが、機能は Button コントロールと同じです。コントロールをクリックしたときに別の Web ページにリンクするには、HyperLink コントロールを使用します。

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

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

1cd4z1zs.alert_note(ja-jp,VS.90).gifメモ :

LinkButton コントロールは、JavaScript をクライアント ブラウザに描画します。このコントロールが正常に動作するには、クライアント ブラウザで JavaScript が有効になっている必要があります。クライアント スクリプトの詳細については、「ASP.NET Web ページのクライアント スクリプト」を参照してください。既定では、LinkButton コントロールがクリックされたときに、ページの検証が行われます。ページ検証では、ページ上の検証コントロールに関連付けられている入力コントロールが、その検証コントロールによって指定されている入力規則を満たしているかどうかが確認されます。reset ボタンなど、この動作を無効にする必要がある LinkButton コントロールがある場合、CausesValidation プロパティを false に設定します。
1cd4z1zs.alert_caution(ja-jp,VS.90).gif注意 :

テキストは、LinkButton コントロールに表示される前には HTML エンコードされません。これにより、テキストの HTML タグ内にスクリプトを埋め込むことができるようになります。コントロールの値がユーザーによって入力された場合は、セキュリティの脆弱性への対策として、入力された値を必ず検証してください。

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

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

使用例

LinkButton コントロールを使用して、コントロールがクリックされたときにメッセージを表示する方法を次の例に示します。

<%@ 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 Example</title>
<script language="VB" runat="server">

      Sub LinkButton_Click(sender As Object, e As EventArgs) 
         Label1.Text = "You clicked the link button"
      End Sub

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>


<%@ 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 Example</title>
<script language="C#" runat="server">

      void LinkButton_Click(Object sender, EventArgs e) 
      {
         Label1.Text="You clicked the link button";
      }

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>


<%@ Page Language="JScript" 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 Example</title>
<script language="JSCRIPT" runat="server">

      function LinkButton_Click(sender : Object, e : EventArgs){
         Label1.Text = "You clicked the link button"
      }

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>

参照

参照

LinkButton

その他の技術情報

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