Language

Label.Text プロパティ

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

Label コントロールのテキスト コンテンツを取得または設定します。

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerDefaultProperty)]
public virtual string Text { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerDefaultProperty)>]
member this.Text : string with get, set
Public Overridable Property Text As String

プロパティ値

String

コントロールのテキスト コンテンツ。 既定値は Empty です。

実装

Text
属性
BindableAttribute PersistenceModeAttribute

例

次の例では、 Label コントロールの新しいインスタンスを作成し、その Text プロパティを設定する方法を示します。

Note

次のコード サンプルでは、単一ファイルコード モデルを使用します。分離コード ファイルに直接コピーした場合、正しく動作しない可能性があります。 このコード サンプルは、.aspx拡張子が付いている空のテキスト ファイルにコピーする必要があります。 Web フォーム コード モデルの詳細については、「Web フォーム ページ コード モデル ASP.NET」を参照してください。

<%@ 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 Button1_Click(Object Sender, EventArgs e) {
            Label l2 = new Label();
            l2.Text = "This is a new Label";
            l2.BorderStyle = BorderStyle.Solid;    
            Page.Controls.Add(l2);
         }
     </script>
 
 </head>
 <body>
     <h3>Label Example</h3>
     <form id="form1" runat="server">
 
         <asp:Button id="Button1" Text="Create and Show a Label" 
         OnClick="Button1_Click" 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>Label Example</title>
<script language="VB" runat="server">
         Sub Button1_Click(Sender As Object, e As EventArgs)
            Dim l2 As New Label()
            l2.Text = "This is a new Label"
            l2.BorderStyle = BorderStyle.Solid
            Page.Controls.Add(l2)
         End Sub
     </script>
 
 </head>
 <body>
     <h3>Label Example</h3>
     <form id="form1" runat="server">
 
         <asp:Button id="Button1" Text="Create and Show a Label" 
         OnClick="Button1_Click" Runat="server"/>
 
     </form>
 </body>
 </html>

注釈

Text コントロールのテキスト コンテンツを指定または決定するには、Label プロパティを使用します。 このプロパティは、 Label コントロールに表示されるテキストをプログラムでカスタマイズするために一般的に使用されます。

Textプロパティには HTML を含めることができます。 その場合、HTML は変更されずにブラウザーに渡され、テキストとしてではなくマークアップとして解釈される可能性があります。 ブラウザーで HTML マークアップをプレーン テキストとして表示する場合は、クラスの概要の例に示すように、 HtmlEncode メソッドを使用できます。 Literal コントロールの代わりにLabel コントロールを使用し、Mode プロパティをEncodeに設定することもできます。

Note

Text プロパティを設定すると、Label コントロールに含まれるその他のコントロールがクリアされます。

Important

このコントロールを使用して、潜在的なセキュリティ上の脅威であるユーザー入力を表示できます。 既定では、ASP.NET Web ページでは、ユーザー入力にスクリプトや HTML 要素が含まれていないことが検証されます。 詳細については、「スクリプトの 悪用の概要」を参照してください。

このプロパティの値を設定すると、デザイナー ツールを使用してリソース ファイルに自動的に保存できます。 詳細については、「グローバリゼーションとローカリゼーションのLocalizableAttributeと ASP.NET」を参照してください。

このプロパティは、 ControlParameter オブジェクトが実行時にバインドする既定のプロパティです。 詳細については、「 ControlValuePropertyAttribute、 ControlParameter、および フィルター処理のためのデータ ソース コントロールでのパラメーターの使用」を参照してください。

適用対象