System.Web 2.0.0.0 System.Web.UI.WebControls.Adapters.WebControlAdapter

The class adapts the associated control to modify the default markup or behavior for a specific browser. You can extend the class to further customize rendering of the control.

Adapters are compiled .NET Framework components that take over one or more stages in the life cycle of a page or control. Extending the class will provide access to the life-cycle stages of the control. For more information, see Architectural Overview of Adaptive Control Behavior.

The initial request for an adapter causes the .NET Framework to search for a mapped adapter for the control given the characteristics of the requesting browser. Browser definition files are used by the class to identify the characteristics of the client browser and map the adapter to the browser type. For more information, see Architectural Overview of Adaptive Control Behavior.

For a description of the adaptive rendering architecture of ASP.NET and a step-by-step walkthrough that shows how to implement a control adapter and map it to a control, see "Authoring ASP.NET Server Control Adapters: An Introduction" in the MSDN Library at http://msdn.microsoft.com/library.

Provides rendering capabilities for the associated Web control to modify the default markup or behavior for a specific browser.

- Constructor

  The .NET Framework constructs an instance of the class. The initial request for an adapter causes the .NET Framework to search for a mapped adapter for the control given the characteristics of the requesting browser. Once found, the control holds a reference to the mapped adapter instance in its property. For information on adapter mappings and browser definition files, see Architectural Overview of Adaptive Control Behavior.

  Initializes a new instance of the class.

  2.0.0.0
- Method
  2.0.0.0
  System.Void ``

  The method writes the associated control to the output stream as HTML.

  By default, the .NET Framework calls on the Web server control's own method. However, once the property of that control is set, the .NET Framework will execute the adapter's implementation of the event over that of the associated control.

  The event is used to perform modifications to the markup code that is rendered to a device browser. Control properties should be set prior to this phase of the life cycle and only the actual markup creation for the control done here. Changes made to the control in this stage of the life cycle are not saved to view state. For saving changes made to the control, override the event.

  The event also allows derived classes to handle the event without attaching a delegate, which is the preferred technique for handling the event in a derived class.

  Writes the associated Web control to the output stream as HTML.

  The containing methods to build and render the device-specific output.