DataBoundLiteralControl.Text Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets the text content of the DataBoundLiteralControl object.
public:
property System::String ^ Text { System::String ^ get(); };
public string Text { get; }
member this.Text : string
Public ReadOnly Property Text As String
Property Value
A String that represents the text content of the DataBoundLiteralControl.
Examples
The following code example creates a custom control and uses that control from within an .aspx file to display the text of a DataBoundLiteralControl object. The custom control obtains a DataBoundLiteralControl object and outputs the text property in its Render
method.
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
You can compile the control with the Visual Basic Compiler (vbc.exe) or C# Compiler (csc.exe). You must place the resulting .dll file in the Bin directory of the Web project, as shown in the following code example.
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
The following code example demonstrates how the custom control is registered and used within an .aspx file.
<%@ 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>
Remarks
The DataBoundLiteralControl class persists the value of its Text property to view state.
Applies to
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기