Gets or sets the name of the control.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
The String type, it can be evaluated in case-style logic statements (Select statement in Visual Basic, switch statement in Visual C# and Visual C++).property can be used at run time to evaluate the object by name rather than type and programmatic name. Because the property returns a
The following code example displays the MessageBox when the control is added or removed from a form.of a control in a
' This example demonstrates the use of the ControlAdded and ' ControlRemoved events. This example assumes that two Button controls ' are added to the form and connected to the addControl_Click and ' removeControl_Click event-handler methods. Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load ' Connect the ControlRemoved and ControlAdded event handlers to the event-handler methods. ' ControlRemoved and ControlAdded are not available at design time. AddHandler Me.ControlRemoved, AddressOf Me.Control_Removed AddHandler Me.ControlAdded, AddressOf Me.Control_Added End Sub 'Form1_Load Private Sub Control_Added(ByVal sender As Object, ByVal e As System.Windows.Forms.ControlEventArgs) MessageBox.Show(("The control named " + e.Control.Name + " has been added to the form.")) End Sub Private Sub Control_Removed(ByVal sender As Object, ByVal e As System.Windows.Forms.ControlEventArgs) MessageBox.Show(("The control named " + e.Control.Name + " has been removed from the form.")) End Sub ' Click event handler for a Button control. Adds a TextBox to the form. Private Sub addControl_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click ' Create a new TextBox control and add it to the form. Dim textBox1 As New TextBox() textBox1.Size = New Size(100, 10) textBox1.Location = New Point(10, 10) ' Name the control in order to remove it later. ' The name must be specified if a control is added at run time. textBox1.Name = "textBox1" ' Add the control to the form's control collection. Me.Controls.Add(textBox1) End Sub ' Click event handler for a Button control. ' Removes the previously added TextBox from the form. Private Sub removeControl_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button2.Click ' Loop through all controls in the form's control collection. Dim tempCtrl As Control For Each tempCtrl In Me.Controls ' Determine whether the control is textBox1, ' and if it is, remove it. If tempCtrl.Name = "textBox1" Then Me.Controls.Remove(tempCtrl) End If Next tempCtrl End Sub
Available since 1.1