Label.Text プロパティ

  • [アーティクル]

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

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)

構文

'宣言
<LocalizableAttribute(True)> _
<BindableAttribute(True)> _
Public Overridable Property Text As String
'使用
Dim instance As Label
Dim value As String

value = instance.Text

instance.Text = value

[LocalizableAttribute(true)] 
[BindableAttribute(true)] 
public virtual string Text { get; set; }

[LocalizableAttribute(true)] 
[BindableAttribute(true)] 
public:
virtual property String^ Text {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_Text ()

/** @property */
public void set_Text (String value)

public function get Text () : String

public function set Text (value : String)

適用できません。

プロパティ値

コントロールのテキストの内容。既定値は String.Empty です。

解説

Text プロパティを使用して、Label コントロールのテキストの内容を指定または確認します。通常、このプロパティは、Label コントロールに表示されるテキストをプログラムによりカスタマイズするために使用します。Text プロパティには HTML を含めることができます。

メモメモ :

Text プロパティを設定すると、Label コントロール内に含まれているその他のコントロールが削除されます。
セキュリティに関するメモセキュリティに関するメモ :

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

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

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

トピック 場所
チュートリアル : ASP.NET Web サーバー コントロール用の基本的なコントロール デザイナの作成 ASP.NET コントロールの作成
方法 : Web フォーム ページに Label Web サーバー コントロールを追加する (Visual Studio) Visual Studio での ASP .NET Web アプリケーションの作成
チュートリアル : Web サーバー コントロール用の基本的なコントロール デザイナの作成 Visual Studio ASP .NET での Web アプリケーションの作成
方法 : Web フォーム ページに Label Web サーバー コントロールを追加する (Visual Studio) Visual Studio ASP .NET での Web アプリケーションの作成
チュートリアル : Web サーバー コントロール用の基本的なコントロール デザイナの作成 Visual Studio ASP .NET での Web アプリケーションの作成
方法 : Web フォーム ページに Label Web サーバー コントロールを追加する (Visual Studio) Visual Studio ASP .NET での Web アプリケーションの作成
方法 : Web フォーム ページに Label Web サーバー コントロールを追加する ASP .NET Web アプリケーションの作成

使用例

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

メモメモ :

次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .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 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>
   

<%@ 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="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>Label Example</title>
<script language="JScript" runat="server">
         function Button1_Click(Sender : Object, e : EventArgs) {
            var l2 : Label = 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>

プラットフォーム

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

参照

関連項目

Label クラス
Label メンバ
System.Web.UI.WebControls 名前空間

その他の技術情報

Label Web サーバー コントロール
標準コントロールのセキュリティ保護
方法 : HTML エンコーディングを文字列に適用して Web アプリケーションをスクリプトによる攻略から保護する
ASP.NET Web ページにおけるユーザー入力の検証