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.
Imports System 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 'Render End Class 'MyControl 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
The following code example demonstrates how the custom control is registered and used within an .aspx file.
<%@ 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>
Available since 1.1