DataBoundLiteralControl.Text Property
Gets the text content of the DataBoundLiteralControl object.
Assembly: System.Web (in System.Web.dll)
Property Value
Type: System.StringA String that represents the text content of the DataBoundLiteralControl.
The DataBoundLiteralControl class persists the value of its Text property to view state.
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>"); } } } }
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.
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>
Available since 1.1