DataBoundLiteralControl Class
.NET Framework 4.5
Retains data-binding expressions and static literal text. This class cannot be inherited.
Namespace: System.Web.UI
Assembly: System.Web (in System.Web.dll)
The DataBoundLiteralControl type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | DataBoundLiteralControl | Infrastructure. Initializes a new instance of the DataBoundLiteralControl class. |
| Name | Description | |
|---|---|---|
![]() | AppRelativeTemplateSourceDirectory | Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control. (Inherited from Control.) |
![]() | BindingContainer | Infrastructure. Gets the control that contains this control's data binding. (Inherited from Control.) |
![]() | ClientID | Gets the control ID for HTML markup that is generated by ASP.NET. (Inherited from Control.) |
![]() | ClientIDMode | Gets or sets the algorithm that is used to generate the value of the ClientID property. (Inherited from Control.) |
![]() | Context | Gets the HttpContext object associated with the server control for the current Web request. (Inherited from Control.) |
![]() | Controls | Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy. (Inherited from Control.) |
![]() | DataItemContainer | Gets a reference to the naming container if the naming container implements IDataItemContainer. (Inherited from Control.) |
![]() | DataKeysContainer | Gets a reference to the naming container if the naming container implements IDataKeysControl. (Inherited from Control.) |
![]() | DesignMode | Gets a value indicating whether a control is being used on a design surface. (Inherited from Control.) |
![]() | EnableTheming | Gets or sets a value indicating whether themes apply to this control. (Inherited from Control.) |
![]() | EnableViewState | Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client. (Inherited from Control.) |
![]() | ID | Gets or sets the programmatic identifier assigned to the server control. (Inherited from Control.) |
![]() | IsChildControlStateCleared | Gets a value indicating whether controls contained within this control have control state. (Inherited from Control.) |
![]() | IsViewStateEnabled | Gets a value indicating whether view state is enabled for this control. (Inherited from Control.) |
![]() | NamingContainer | Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same Control.ID property value. (Inherited from Control.) |
![]() | Page | Gets a reference to the Page instance that contains the server control. (Inherited from Control.) |
![]() | Parent | Gets a reference to the server control's parent control in the page control hierarchy. (Inherited from Control.) |
![]() | RenderingCompatibility | Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with. (Inherited from Control.) |
![]() | Site | Gets information about the container that hosts the current control when rendered on a design surface. (Inherited from Control.) |
![]() | SkinID | Gets or sets the skin to apply to the control. (Inherited from Control.) |
![]() | TemplateControl | Gets or sets a reference to the template that contains this control. (Inherited from Control.) |
![]() | TemplateSourceDirectory | Gets the virtual directory of the Page or UserControl that contains the current server control. (Inherited from Control.) |
![]() | Text | Gets the text content of the DataBoundLiteralControl object. |
![]() | UniqueID | Gets the unique, hierarchically qualified identifier for the server control. (Inherited from Control.) |
![]() | ValidateRequestMode | Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values. (Inherited from Control.) |
![]() | ViewStateMode | Gets or sets the view-state mode of this control. (Inherited from Control.) |
![]() | Visible | Gets or sets a value that indicates whether a server control is rendered as UI on the page. (Inherited from Control.) |
| Name | Description | |
|---|---|---|
![]() | AddedControl | Called after a child control is added to the Controls collection of the Control object. (Inherited from Control.) |
![]() | ApplyStyleSheetSkin | Applies the style properties defined in the page style sheet to the control. (Inherited from Control.) |
![]() | CreateChildControls | Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering. (Inherited from Control.) |
![]() | DataBind() | Binds a data source to the invoked server control and all its child controls. (Inherited from Control.) |
![]() | Dispose | Enables a server control to perform final clean up before it is released from memory. (Inherited from Control.) |
![]() | Equals(Object) | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
![]() | FindControl(String) | Searches the current naming container for a server control with the specified id parameter. (Inherited from Control.) |
![]() | Focus | Sets input focus to a control. (Inherited from Control.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetRouteUrl(Object) | Gets the URL that corresponds to a set of route parameters. (Inherited from Control.) |
![]() | GetRouteUrl(RouteValueDictionary) | Gets the URL that corresponds to a set of route parameters. (Inherited from Control.) |
![]() | GetRouteUrl(String, Object) | Gets the URL that corresponds to a set of route parameters and a route name. (Inherited from Control.) |
![]() | GetRouteUrl(String, RouteValueDictionary) | Gets the URL that corresponds to a set of route parameters and a route name. (Inherited from Control.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | GetUniqueIDRelativeTo | Returns the prefixed portion of the UniqueID property of the specified control. (Inherited from Control.) |
![]() | HasControls | Determines if the server control contains any child controls. (Inherited from Control.) |
![]() | LoadControlState | Restores control-state information from a previous page request that was saved by the SaveControlState method. (Inherited from Control.) |
![]() | MapPathSecure | Retrieves the physical path that a virtual path, either absolute or relative, maps to. (Inherited from Control.) |
![]() | OnInit | Raises the Init event. (Inherited from Control.) |
![]() | OnLoad | Raises the Load event. (Inherited from Control.) |
![]() | OnPreRender | Raises the PreRender event. (Inherited from Control.) |
![]() | OnUnload | Raises the Unload event. (Inherited from Control.) |
![]() | OpenFile | Gets a Stream used to read a file. (Inherited from Control.) |
![]() | RemovedControl | Called after a child control is removed from the Controls collection of the Control object. (Inherited from Control.) |
![]() | Render | Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client. (Inherited from Control.) |
![]() | RenderChildren | Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client. (Inherited from Control.) |
![]() | RenderControl(HtmlTextWriter) | Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled. (Inherited from Control.) |
![]() | ResolveClientUrl | Gets a URL that can be used by the browser. (Inherited from Control.) |
![]() | ResolveUrl | Converts a URL into one that is usable on the requesting client. (Inherited from Control.) |
![]() | SaveControlState | Saves any server control state changes that have occurred since the time the page was posted back to the server. (Inherited from Control.) |
![]() | SetDataBoundString | Infrastructure. Assigns a string value to an array containing data-bound values. |
![]() | SetRenderMethodDelegate | Infrastructure. Assigns an event handler delegate to render the server control and its content into its parent control. (Inherited from Control.) |
![]() | SetStaticString | Infrastructure. Assigns a string value to an array containing static values. |
![]() | SetTraceData(Object, Object) | Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value. (Inherited from Control.) |
![]() | SetTraceData(Object, Object, Object) | Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value. (Inherited from Control.) |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Name | Description | |
|---|---|---|
![]() | DataBinding | Occurs when the server control binds to a data source. (Inherited from Control.) |
![]() | Disposed | Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested. (Inherited from Control.) |
![]() | Init | Occurs when the server control is initialized, which is the first step in its lifecycle. (Inherited from Control.) |
![]() | Load | Occurs when the server control is loaded into the Page object. (Inherited from Control.) |
![]() | PreRender | Occurs after the Control object is loaded but prior to rendering. (Inherited from Control.) |
![]() | Unload | Occurs when the server control is unloaded from memory. (Inherited from Control.) |
| Name | Description | |
|---|---|---|
![]() | FindDataSourceControl | Returns the data source that is associated with the data control for the specified control. (Defined by DynamicDataExtensions.) |
![]() | FindFieldTemplate | Returns the field template for the specified column in the specified control's naming container. (Defined by DynamicDataExtensions.) |
![]() | FindMetaTable | Returns the metatable object for the containing data control. (Defined by DynamicDataExtensions.) |
Top
The following code example creates a class that obtains a DataBoundLiteralControl object and displays the Text property of the object.
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>"); } } } }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

