DataBoundControlAdapter Class
Assembly: System.Web (in system.web.dll)
A control derived from the DataBoundControl class is bound to a data source and generates its user interface or child control hierarchy by enumerating the items in the data source to which it is bound. DataBoundControl is an abstract base class that defines the common characteristics of all controls that can be bound to a data source, such as the DataGrid and ListBox controls. For more information, see DataBoundControl.
A DataBoundControlAdapter modifies the behavior of a DataBoundControl for a specific browser or class of browsers, or acts as a filter on some capability. Much of the adaptability in rendering behavior can be encapsulated in the specialized classes that derive from the HtmlTextWriter class. Therefore, it is likely that a single adapter can be used for a number of browser class behaviors or that inclusion of the adaptability in the HtmlTextWriter classes can make the use of a control adapter unnecessary.
Each control has explicit mappings to adapters through the .browser definition files, if there are <controlAdapter> entries in these files. Thus, any access to the Adapter property of the DataBoundControl uses the HttpBrowserCapabilities object extracted from the .browser definition files to perform the lookup for the mapping of the adapter to control.
During processing, the .NET Framework intercepts calls to the methods of a control that could be browser specific. If a control adapter is attached, the .NET Framework calls the associated adapter methods. For more information, see ControlAdapter.
The M:System.Web.UI.WebControls.Adapters.DataBoundControlAdapter.PerformDataBinding(System.Collections.IEnumerable) method binds an enumerable collection to the associated DataBoundControl. The Control property returns a strongly typed reference to the DataBoundControl.
The following code examples create and use two derived controls:
-
The MyDataBound class, derived from DataBoundControl, is a simple read-only grid control.
-
The MyDataBoundAdapter class, derived from DataBoundControlAdapter, renders the grid data as a one-dimensional list with row separators, suitable for small screen browsers.
The first code example uses a Web page to declare a MyDataBound control and an instance of ObjectDataSource that provides data in the form of a DataView object.
The second code example contains the derived MyDataBound and MyDataBoundAdapter classes:
-
The MyDataBound class overrides the PerformDataBinding method to save an IEnumerator collection for the data source, and overrides the RenderContents method to render the data source as an HTML <table>.
-
The MyDataBoundAdapter class overrides PerformDataBinding to save the data source to a one-dimensional ArrayList and add row separators. It overrides RenderContents to render the ArrayList as a list of fields separated by <br /> tags.
The third code example uses a configuration file to specify that no control adapter is to be used with MyDataBound controls for Microsoft Internet Explorer browsers, and that a MyDataBoundAdapter is used with MyDataBound controls for Openwave UP browsers.
- AspNetHostingPermission for verifying at compilation time that the immediate caller into DataBoundControlAdapter has this permission. Associated enumerations: LinkDemand, Minimal
- AspNetHostingPermission for verifying at load time that the class derived from DataBoundControlAdapter has this permission. Associated enumerations: InheritanceDemand, Minimal
System.Web.UI.Adapters.ControlAdapter
System.Web.UI.WebControls.Adapters.WebControlAdapter
System.Web.UI.WebControls.Adapters.DataBoundControlAdapter
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.