Label.Text プロパティ

[アーティクル]
06/26/2007

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 要素が含まれていないかどうかが検証されます。詳細については、「スクリプトによる攻略の概要」を参照してください。

このコントロールは、ユーザー入力を表示する際に使用できます。これにより、セキュリティが脆弱になる可能性があります。既定では、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 ページのコードモデル」を参照してください。

次のコードサンプルはシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコードサンプルは、拡張子が .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 Web サーバーコントロール
 標準コントロールのセキュリティ保護
 方法 : HTML エンコーディングを文字列に適用して Web アプリケーションをスクリプトによる攻略から保護する
 ASP.NET Web ページにおけるユーザー入力の検証

次の方法で共有