UserControl Constructor
Initializes a new instance of the UserControl class.
[Visual Basic] Public Sub New() [C#] public UserControl(); [C++] public: UserControl(); [JScript] public function UserControl();
Remarks
You do not typically create an instance of UserControl. To create your own user control class, inherit from the UserControl class.
Example
[Visual Basic, C#, C++] The following example creates an instance of the UserControl derived class, MyCustomerInfoUserControl, which was created in the example section of the UserControl class overview. The user control is added to a Panel control and has its Dock property set to DockStyle.Fill. The Panel is then added to a Form.
[Visual Basic] Imports System Imports System.Drawing Imports System.Windows.Forms Imports System.ComponentModel Imports Microsoft.VisualBasic Imports UserControls Namespace MyApplication Public Class MyUserControlHost Inherits System.Windows.Forms.Form ' Create the controls. Private components As System.ComponentModel.IContainer Private panel1 As System.Windows.Forms.Panel Private myUserControl As UserControls.MyCustomerInfoUserControl ' Define the constructor. Public Sub New() Me.InitializeComponent() End Sub <System.STAThreadAttribute()> _ Public Shared Sub Main() System.Windows.Forms.Application.Run(New MyUserControlHost()) End Sub ' Add a Panel control to a Form and host the UserControl in the Panel. Private Sub InitializeComponent() components = New System.ComponentModel.Container() panel1 = New System.Windows.Forms.Panel() myUserControl = New UserControls.MyCustomerInfoUserControl() ' Set the DockStyle of the UserControl to Fill. myUserControl.Dock = System.Windows.Forms.DockStyle.Fill ' Make the Panel the same size as the UserControl and give it a border. panel1.BorderStyle = System.Windows.Forms.BorderStyle.FixedSingle panel1.Size = myUserControl.Size panel1.Location = New System.Drawing.Point(5, 5) ' Add the user control to the Panel. panel1.Controls.Add(myUserControl) Me.AutoScaleBaseSize = New System.Drawing.Size(5, 13) ' Size the Form to accommodate the Panel. Me.ClientSize = New System.Drawing.Size(panel1.Size.Width + 10, panel1.Size.Height + 10) Me.Text = "Please enter the information below..." ' Add the Panel to the Form. Me.Controls.Add(panel1) End Sub End Class End Namespace [C#] using System; using System.Drawing; using System.Windows.Forms; using System.ComponentModel; using UserControls; namespace MyApplication { public class MyUserControlHost : System.Windows.Forms.Form { // Create the controls. private System.ComponentModel.IContainer components; private System.Windows.Forms.Panel panel1; private UserControls.MyCustomerInfoUserControl myUserControl; // Define the constructor. public MyUserControlHost() { this.InitializeComponent(); } [System.STAThreadAttribute()] public static void Main() { System.Windows.Forms.Application.Run(new MyUserControlHost()); } // Add a Panel control to a Form and host the UserControl in the Panel. private void InitializeComponent() { components = new System.ComponentModel.Container(); panel1 = new System.Windows.Forms.Panel(); myUserControl = new UserControls.MyCustomerInfoUserControl(); // Set the DockStyle of the UserControl to Fill. myUserControl.Dock = System.Windows.Forms.DockStyle.Fill; // Make the Panel the same size as the UserControl and give it a border. panel1.BorderStyle = System.Windows.Forms.BorderStyle.FixedSingle; panel1.Size = myUserControl.Size; panel1.Location = new System.Drawing.Point(5, 5); // Add the user control to the Panel. panel1.Controls.Add(myUserControl); this.AutoScaleBaseSize = new System.Drawing.Size(5, 13); // Size the Form to accommodate the Panel. this.ClientSize = new System.Drawing.Size( panel1.Size.Width + 10, panel1.Size.Height + 10); this.Text = "Please enter the information below..."; // Add the Panel to the Form. this.Controls.Add(panel1); } } // End Class } // End Namespace [C++] public __gc class MyUserControlHost : public System::Windows::Forms::Form { // Create the controls. private: System::ComponentModel::IContainer* components; System::Windows::Forms::Panel* panel1; UserControls::MyCustomerInfoUserControl* myUserControl; // Define the constructor. public: MyUserControlHost() { this->InitializeComponent(); } // Add a Panel control to a Form and host the UserControl in the Panel. private: void InitializeComponent() { components = new System::ComponentModel::Container(); panel1 = new System::Windows::Forms::Panel(); myUserControl = new UserControls::MyCustomerInfoUserControl(); // Set the DockStyle of the UserControl to Fill. myUserControl->Dock = System::Windows::Forms::DockStyle::Fill; // Make the Panel the same size as the UserControl and give it a border. panel1->BorderStyle = System::Windows::Forms::BorderStyle::FixedSingle; panel1->Size = myUserControl->Size; panel1->Location = System::Drawing::Point(5, 5); // Add the user control to the Panel. panel1->Controls->Add(myUserControl); this->AutoScaleBaseSize = System::Drawing::Size(5, 13); // Size the Form to accommodate the Panel. this->ClientSize = System::Drawing::Size( panel1->Size.Width + 10, panel1->Size.Height + 10); this->Text = S"Please enter the information below..."; // Add the Panel to the Form. this->Controls->Add(panel1); } }; // End Class [System::STAThreadAttribute] int main() { System::Windows::Forms::Application::Run(new MyUserControlHost()); }
[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
See Also
UserControl Class | UserControl Members | System.Windows.Forms Namespace