DataBoundLiteralControl.Text 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得物件的 DataBoundLiteralControl 文字內容。
public:
property System::String ^ Text { System::String ^ get(); };
public string Text { get; }
member this.Text : string
Public ReadOnly Property Text As String
屬性值
String A 代表 的文字內容DataBoundLiteralControl。
範例
以下程式碼範例建立自訂控制項,並利用該控制項從.aspx檔案中顯示物件 DataBoundLiteralControl 的文字。 自訂控制項會取得物件 DataBoundLiteralControl ,並在其 Render 方法中輸出文字屬性。
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>");
}
}
}
}
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
End Class
End Namespace 'MyUserControl
你可以用 Visual Basic 編譯器(vbc.exe)或 C# 編譯器(csc.exe)來編譯這個控制項。 您必須將產生的 .dll 檔案放入網頁專案的 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="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>
<%@ 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>
備註
該 DataBoundLiteralControl 類別持續其屬性的值 Text 以呈現狀態。