ControlAdapter.Control Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a reference to the control to which this control adapter is attached.
protected:
property System::Web::UI::Control ^ Control { System::Web::UI::Control ^ get(); };
[System.ComponentModel.Browsable(false)]
protected System.Web.UI.Control Control { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Control : System.Web.UI.Control
Protected ReadOnly Property Control As Control
Property Value
The Control to which this ControlAdapter is attached.
- Attributes
Examples
The following code example shows how to derive a custom control from the Control class, and then create a corresponding adapter that inherits from the ControlAdapter class. The adapter overrides the Control property and returns a strongly-typed reference to the control.
#using <System.Web.Mobile.dll>
#using <System.dll>
#using <System.Web.dll>
using namespace System;
using namespace System::Web::UI;
using namespace System::Web::UI::Adapters;
using namespace System::Web::UI::WebControls;
public ref class CustomControl: public Control{};
public ref class CustomControlAdapter: public ControlAdapter
{
public:
property System::Web::UI::Control^ Control
{
// Return a strongly-typed reference to your custom control.
System::Web::UI::Control^ get()
{
return (CustomControl^)ControlAdapter::Control;
}
}
// Override other ControlAdapter members, as necessary.
};
using System;
using System.Web.UI;
using System.Web.UI.Adapters;
using System.Web.UI.WebControls;
public class CustomControl : Control
{
// Add your custom control code.
}
public class CustomControlAdapter : ControlAdapter
{
// Return a strongly-typed reference to your custom control.
public new CustomControl Control
{
get
{
return (CustomControl)base.Control;
}
// Override other ControlAdapter members, as necessary.
}
}
Imports System.Web.UI
Imports System.Web.UI.Adapters
Imports System.Web.UI.WebControls
Public Class CustomControl
Inherits Control
' Add your custom control code.
End Class
Public Class CustomControlAdapter
Inherits ControlAdapter
' Return a strongly-typed reference to your custom control.
Public Shadows ReadOnly Property Control() As CustomControl
Get
Return CType(MyBase.Control, CustomControl)
End Get
End Property
' Override other ControlAdapter member as necessary.
End Class
Remarks
When a derived control adapter is attached to a control, the .NET Framework calls certain adapter members instead of the control members.
Notes to Inheritors
When you inherit from the ControlAdapter class, at a minimum, you should implement a Control
property to return a strongly-typed instance of the control, as shown in the Example section.