DataBoundLiteralControl.Text プロパティ
DataBoundLiteralControl オブジェクトのテキストの内容を取得します。
名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文
'宣言
Public ReadOnly Property Text As String
'使用
Dim instance As DataBoundLiteralControl
Dim value As String
value = instance.Text
public string Text { get; }
public:
property String^ Text {
String^ get ();
}
/** @property */
public String get_Text ()
public function get Text () : String
適用できません。
プロパティ値
DataBoundLiteralControl のテキストの内容を表す String。
解説
DataBoundLiteralControl クラスは、Text プロパティの値をビューステートに永続化します。
使用例
カスタム コントロールを作成し、このコントロールを .aspx ファイル内から使用して、DataBoundLiteralControl オブジェクトのテキストを表示する方法を次のコード例に示します。このカスタム コントロールは DataBoundLiteralControl オブジェクトを取得し、Render
メソッドを使用してテキスト プロパティを出力します。
Imports System
Imports System.Web
Imports System.Web.UI
Namespace Samples.AspNet.VB.Controls
Public Class MyControlVB
Inherits Control
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub Render(Output As HtmlTextWriter)
' Checks if a DataBoundLiteralControl object is present.
If HasControls() And TypeOf Controls(0) Is DataBoundLiteralControl Then
' Obtains the DataBoundLiteralControl instance.
Dim boundLiteralControl As DataBoundLiteralControl = CType(Controls(0), DataBoundLiteralControl)
' Retrieves the text in the boundLiteralControl object.
Dim text As String = boundLiteralControl.Text
output.Write(("<h4>Your Message: " + text + "</h4>"))
End If
End Sub 'Render
End Class 'MyControl
End Namespace 'MyUserControl
using System;
using System.Web;
using System.Web.UI;
namespace Samples.AspNet.CS.Controls
{
public class MyControl : Control
{
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void Render(HtmlTextWriter output)
{
// Checks if a DataBoundLiteralControl object is present.
if ( (HasControls()) && (Controls[0] is DataBoundLiteralControl) )
{
// Obtains the DataBoundLiteralControl instance.
DataBoundLiteralControl boundLiteralControl = (DataBoundLiteralControl)Controls[0];
// Retrieves the text in the boundLiteralControl object.
String text = boundLiteralControl.Text;
output.Write("<h4>Your Message: " +text+"</h4>");
}
}
}
}
/*File name: myDataBoundLiteralControl.jsl */
import System.*;
import System.Web.*;
import System.Web.UI.*;
public class MyControl extends Control
{
protected void Render(HtmlTextWriter output)
{
// Checks if a DataBoundLiteralControl object is present.
if (HasControls() && get_Controls().get_Item(0)
instanceof DataBoundLiteralControl) {
// Obtains the DataBoundLiteralControl instance.
DataBoundLiteralControl boundLiteralControl =
(DataBoundLiteralControl)get_Controls().get_Item(0);
// Retrieves the text in the boundLiteralControl object.
String text = boundLiteralControl.get_Text();
output.Write("<h4>Your Message: " + text + "</h4>");
}
} //Render
} //MyControl
Visual Basic コンパイラ (vbc.exe) または C# コンパイラ (csc.exe) を使用して、コントロールをコンパイルできます。結果として得られた .dll ファイルは、次のコード例に示すように、Web プロジェクトの Bin ディレクトリに配置する必要があります。
vbc /r:System.dll /r:System.Web.dll /t:library /out:myWebAppPath/bin/vb_myDataBoundLiteralControl.dll myDataBoundLiteralControl.vb
csc /t:library /out:myWebAppPath/bin/cs_myDataBoundLiteralControl.dll myDataBoundLiteralControl.cs
カスタム コントロールを作成し、.aspx ファイルに登録して使用する方法を次のコード例に示します。
<%@ Page Language="VB" %>
<%@ Register TagPrefix="MyControlSample" Namespace="Samples.AspNet.VB.Controls" %>
<!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>
DataBoundLiteralControl Example
</title>
<script language="VB" runat="server">
Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
Page.DataBind()
End Sub
</script>
</head>
<body>
<h3>
DataBoundLiteralControl Example
</h3>
<form method="post" runat="server" id="Form1">
<asp:Label id="Label1" Text="This is a string retrieved from 'DataBoundLiteralControl'" Runat="server" Visible="False"></asp:Label>
<MyControlSample:MyControlVB id="MyControl" runat="server">
<%# Label1.Text %>
</MyControlSample:MyControlVB>
</form>
</body>
</html>
<%@ Page Language="C#" %>
<%@ Register TagPrefix="MyControlSample" Namespace="Samples.AspNet.CS.Controls" %>
<!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>
DataBoundLiteralControl Example
</title>
<script language="C#" runat="server">
void Page_Load(Object Sender, EventArgs e)
{
Page.DataBind();
}
</script>
</head>
<body>
<h3>
DataBoundLiteralControl Example
</h3>
<form method="post" runat="server" id="Form1">
<asp:Label id="Label1" Text="This is a string retrieved from 'DataBoundLiteralControl'" Runat="server" Visible="False"></asp:Label>
<MyControlSample:MyControl id="MyControl" runat="server">
<%# Label1.Text %>
</MyControlSample:MyControl>
</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
参照
関連項目
DataBoundLiteralControl クラス
DataBoundLiteralControl メンバ
System.Web.UI 名前空間