Export (0) Print
Expand All

Control.CreateHandle Method

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()

ExceptionCondition
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.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft