This topic has not yet been rated - Rate this topic

DataBoundLiteralControl Class

.NET Framework 4.5

Other Versions

Retains data-binding expressions and static literal text. This class cannot be inherited.

Inheritance Hierarchy

System::Object
System.Web.UI::Control
System.Web.UI::DataBoundLiteralControl

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

Syntax

C++

public ref class DataBoundLiteralControl sealed : public Control, 
	ITextControl

ASP.NET

<asp:DataBoundLiteralControl />

The DataBoundLiteralControl type exposes the following members.

Constructors

	Name	Description
	DataBoundLiteralControl	Infrastructure. Initializes a new instance of the DataBoundLiteralControl class.

Top

Properties

	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.)

Top

Methods

	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 the default hash function. (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.)

Top

Events

	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.)

Top

Extension Methods

	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

Explicit Interface Implementations

	Name	Description
	IControlBuilderAccessor::ControlBuilder	For a description of this member, see IControlBuilderAccessor::ControlBuilder. (Inherited from Control.)
	IControlDesignerAccessor::GetDesignModeState	For a description of this member, see IControlDesignerAccessor::GetDesignModeState. (Inherited from Control.)
	IControlDesignerAccessor::SetDesignModeState	For a description of this member, see IControlDesignerAccessor::SetDesignModeState. (Inherited from Control.)
	IControlDesignerAccessor::SetOwnerControl	Infrastructure. For a description of this member, see IControlDesignerAccessor::SetOwnerControl. (Inherited from Control.)
	IControlDesignerAccessor::UserData	For a description of this member, see IControlDesignerAccessor::UserData. (Inherited from Control.)
	IDataBindingsAccessor::DataBindings	For a description of this member, see IDataBindingsAccessor::DataBindings. (Inherited from Control.)
	IDataBindingsAccessor::HasDataBindings	For a description of this member, see IDataBindingsAccessor::HasDataBindings. (Inherited from Control.)
	IExpressionsAccessor::Expressions	For a description of this member, see IExpressionsAccessor::Expressions. (Inherited from Control.)
	IExpressionsAccessor::HasExpressions	For a description of this member, see IExpressionsAccessor::HasExpressions. (Inherited from Control.)
	IParserAccessor::AddParsedSubObject	For a description of this member, see IParserAccessor::AddParsedSubObject. (Inherited from Control.)
	ITextControl::Text	Gets or sets the text content of the DataBoundLiteralControl object.

Top

Remarks

The DataBoundLiteralControl class persists the value of its Text property to view state.

Examples

The following code example creates a class that obtains a DataBoundLiteralControl object and displays the Text property of the object.

C++

No code example is currently available or this language may not be supported.

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Platforms

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.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Reference

System.Web.UI Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)