HideDisabledControlAdapter Class
Provides rendering capabilities for the associated Web control to modify the default markup or behavior for a specific browser.
Assembly: System.Web (in System.Web.dll)
The HideDisabledControlAdapter class adapts the associated WebControl control to modify the default markup or behavior for a specific browser. You can extend the HideDisabledControlAdapter class to further customize rendering of the WebControl 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 HideDisabledControlAdapter class will provide access to the life-cycle stages of the WebControl 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 HttpBrowserCapabilities 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.
The following code example shows how to extend the HideDisabledControlAdapter class to display a Label control in an enabled and disabled state. This example contains three parts:
An adapter derived from the HideDisabledControlAdapter class.
The .aspx file that incorporates the Label control and device-specific content.
A browser file to link the adapter to a device type.
The following code example demonstrates how to extend the HideDisabledControlAdapter class.
The following code example demonstrates how to declare a Label control with device-specific content.
The following code example shows how to link the Label control to the custom adapter for browsers running on Windows CE .NET.
<browsers>
<browser refID="WinCE">
<controlAdapters>
<adapter controlType="System.Web.UI.WebControls.Label"
adapterType="Contoso.HideDisabledControlContosoAdapter" />
</controlAdapters>
</browser>
<browser refID="IE">
<controlAdapters>
<adapter controlType="System.Web.UI.WebControls.Label"
adapterType="Contoso.HideDisabledControlContosoAdapter" />
</controlAdapters>
</browser>
</browsers>
- AspNetHostingPermission
for verifying at compilation time that the immediate caller has permission to call into the HideDisabledControlAdapter class. Associated enumeration: Minimal
- AspNetHostingPermission
for verifying that any class derived from the HideDisabledControlAdapter class has at least the Minimal trust level. Associated enumeration:
System.Web.UI.Adapters::ControlAdapter
System.Web.UI.WebControls.Adapters::WebControlAdapter
System.Web.UI.WebControls.Adapters::HideDisabledControlAdapter
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.