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 示します。

注意

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

<%@ 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 使用し、 プロパティを LabelMode に Encode設定することもできます。

注意

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

重要

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

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

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

適用対象