Control.CreateHandle Method ()

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Creates a handle for the control.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[UIPermissionAttribute(SecurityAction.InheritanceDemand, Window = UIPermissionWindow.AllWindows)]
protected virtual void CreateHandle()

Exception Condition
ObjectDisposedException

The object is in a disposed state.

You typically should not call the CreateHandle method directly. The preferred method is to call the CreateControl method, which forces a handle to be created for the control and its child controls when the control is created.

Notes to Inheritors:

When overriding CreateHandle in a derived class, be sure to call the base class's CreateHandle method to ensure that the handle is created.

UIPermission

for all windows for inheriting classes to call this method. Associated enumeration: AllWindows value of UIPermissionWindow.

.NET Framework
Available since 1.1
Return to top
Show: