DataBoundLiteralControl.Text Property

Definition

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