LinkButton クラス
Web ページにハイパーリンク スタイルのボタン コントロールを表示します。
名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文
'宣言
Public Class LinkButton
Inherits WebControl
Implements IButtonControl, IPostBackEventHandler
'使用
Dim instance As LinkButton
public class LinkButton : WebControl, IButtonControl, IPostBackEventHandler
public ref class LinkButton : public WebControl, IButtonControl, IPostBackEventHandler
public class LinkButton extends WebControl implements IButtonControl, IPostBackEventHandler
public class LinkButton extends WebControl implements IButtonControl, IPostBackEventHandler
適用できません。
解説
LinkButton コントロールを使用して Web ページにハイパーリンク スタイルのボタンを作成します。LinkButton コントロールの外観は HyperLink コントロールと同じですが、機能は Button コントロールと同じです。コントロールがクリックされたときに他の Web ページにリンクさせる必要がある場合は、HyperLink コントロールを使用することを検討してください。
.gif) メモ : |
|---|
LinkButton コントロールは、クライアントのブラウザに JavaScript を表示します。このコントロールが正常に機能するためには、クライアントのブラウザで JavaScript が有効になっている必要があります。クライアント スクリプトの詳細については、「ASP.NET Web ページのクライアント スクリプト」を参照してください。 |
送信ボタンまたはコマンド ボタンを作成できます。送信ボタンに関連付けられているコマンド名はありません。このボタンは Web ページをサーバーにポスト バックするだけです。既定では、LinkButton コントロールは送信ボタンです。Click イベントのイベント ハンドラを作成して、送信ボタンがクリックされたときに実行されるアクションをプログラムにより制御できます。一方、コマンド ボタンには、関連付けられるコマンド名 (Sort など) があります。コマンド名を指定するには、CommandName プロパティを設定します。コマンド名を設定すると、Web ページに複数の LinkButton コントロールを作成し、どの LinkButton コントロールがクリックされたかをプログラムによって確認できます。コマンド ボタンと CommandArgument プロパティを使用すると、昇順の指定など、実行するコマンドに関する情報を追加することもできます。Command イベントのイベント ハンドラを作成して、コマンド ボタンがクリックされたときに実行されるアクションをプログラムにより制御することもできます。
.gif) 注意 : |
|---|
このコントロールは、ユーザー入力を表示するために使用できます。ユーザー入力には悪意のあるクライアント スクリプトが含まれている可能性があります。アプリケーションに表示する前に、クライアントから送信された実行スクリプト、SQL ステートメントなどのコードの情報はすべて検査してください。ASP.NET には入力要求の検証機能があり、ユーザー入力の中のスクリプトと HTML をブロックできます。検証サーバー コントロールは、ユーザー入力を査定する目的でも用意されています。詳細については、「検証サーバー コントロール構文」を参照してください。 |
既定では、LinkButton コントロールがクリックされたときにページ検証を実行します。ページ検証は、ページ上にある検証コントロールに関連付けられたすべての入力コントロールが、その検証コントロールによって指定されている検証規則に準拠しているかどうかを判断します。ページ検証を実行しないようにするには、CausesValidation プロパティを false に設定します。
ユーザー補助
このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。
使用例
リンクがクリックされたときに Label コントロールのテキストを表示する 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>
.NET Framework のセキュリティ
- AspNetHostingPermission ホスト環境での動作に必要なアクセス許可。要求値 : LinkDemand; アクセス許可値 : Minimal。
- AspNetHostingPermission ホスト環境での動作に必要なアクセス許可。要求値 : InheritanceDemand; アクセス許可値 : Minimal。
継承階層
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.LinkButton
スレッド セーフ
この型の public static (Visual Basicでは共有) メンバはすべて,スレッド セーフです。インスタンス メンバの場合は,スレッド セーフであるとは限りません。
プラットフォーム
Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
バージョン情報
.NET Framework
サポート対象 : 3.0,2.0,1.1,1.0
参照
関連項目
LinkButton メンバ
System.Web.UI.WebControls 名前空間
Button
ImageButton
HyperLink