Label Web サーバー コントロールの宣言構文
更新 : 2007 年 11 月
Web フォーム ページに静的テキストを表示し、プログラムによって操作できるようにします。
<asp:Label
AccessKey="string"
AssociatedControlID="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
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"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
ToolTip="string"
Visible="True|False"
Width="size"
/>
解説
Label コントロールを使用して、ページ上の設定された場所にテキストを表示できます。静的テキストとは異なり、Text プロパティを設定することによって、表示するテキストをカスタマイズできます。
![]() |
---|
テキストは、Label コントロールに表示される前には HTML エンコードされません。これにより、テキストの HTML タグ内にスクリプトを埋め込むことができるようになります。コントロールの値がユーザーによって入力された場合は、セキュリティの脆弱性への対策として、入力された値を必ず検証してください。 |
Label Web サーバー コントロールのプロパティとイベントの詳細については、Label のドキュメントを参照してください。
使用例
Label コントロールを Web ページ上に作成する方法を次のコード例に示します。
![]() |
---|
次のコード例では、単一ファイル コード モデルを使用しており、分離コード ファイルに直接コピーすると正常に動作しないことがあります。このコード例は、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。Web フォーム コード モデルの詳細については、「ASP.NET Web ページのコード モデル」を参照してください。 |
<%@ 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>Label Example</title>
<script language="VB" runat="server">
Sub Button_Click(Sender As Object, e As EventArgs)
Label1.Text = Server.HtmlEncode(Text1.Text)
End Sub
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>Label Example</h3>
<asp:Label id="Label1"
Text="Label Control"
runat="server"/>
<p>
<asp:TextBox id="Text1"
Text="Copy this text to the label"
Width="200px"
runat="server" />
<asp:Button id="Button1"
Text="Copy"
OnClick="Button_Click"
runat="server"/>
</p>
</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>Label Example</title>
<script language="C#" runat="server">
void Button_Click(Object Sender, EventArgs e)
{
Label1.Text = Server.HtmlEncode(Text1.Text);
}
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>Label Example</h3>
<asp:Label id="Label1"
Text="Label Control"
runat="server"/>
<p>
<asp:TextBox id="Text1"
Text="Copy this text to the label"
Width="200px"
runat="server" />
<asp:Button id="Button1"
Text="Copy"
OnClick="Button_Click"
runat="server"/>
</p>
</form>
</body>
</html>