This documentation is archived and is not being maintained.
Control.CreateHandle Method
.NET Framework 1.1
Creates a handle for the control.
[Visual Basic] Protected Overridable Sub CreateHandle() [C#] protected virtual void CreateHandle(); [C++] protected: virtual void CreateHandle(); [JScript] protected function CreateHandle();
Exceptions
| Exception Type | Condition |
|---|---|
| ObjectDisposedException | The object is in a disposed state. |
Remarks
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.
Requirements
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
.NET Framework Security:
- UIPermission for all windows for inheriting classes to call this method. Associated enumeration: UIPermissionWindow.AllWindows
See Also
Control Class | Control Members | System.Windows.Forms Namespace | CreateControl | DestroyHandle | RecreateHandle | Handle
Show: