DataBoundLiteralControl.Text Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets the text content of the DataBoundLiteralControl object.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public string Text { get; }

Property Value

Type: System.String

A 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"
<html xmlns="" >
    DataBoundLiteralControl Example
<script language="C#" runat="server">
      void Page_Load(Object Sender, EventArgs e)
    DataBoundLiteralControl Example
  <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 %>

.NET Framework
Available since 1.1
Return to top