Control.ControlCollection.Add(Control) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Aggiunge il controllo specificato all'insieme dei controlli.

public:
 virtual void Add(System::Windows::Forms::Control ^ value);
public virtual void Add (System.Windows.Forms.Control value);
public virtual void Add (System.Windows.Forms.Control? value);
abstract member Add : System.Windows.Forms.Control -> unit
override this.Add : System.Windows.Forms.Control -> unit
Public Overridable Sub Add (value As Control)

Parametri

value
Control

Oggetto Control da aggiungere all'insieme dei controlli.

Eccezioni

Exception

Il controllo specificato è di primo livello oppure viene generato un riferimento circolare al controllo se il controllo viene aggiunto all'insieme dei controlli.

ArgumentException

L'oggetto assegnato al parametro value non è un controllo Control.

Esempio

Nell'esempio di codice seguente viene aggiunto un oggetto Control all'oggetto Control.ControlCollection della classe Panelderivata. L'esempio richiede che sia stato creato un Panel controllo e un Button controllo in un Formoggetto . Quando si fa clic sul pulsante, viene aggiunto un TextBox controllo al pannello.Control.ControlCollection

   // Create a TextBox to add to the Panel.
private:
   TextBox^ textBox1;

   // Add controls to the Panel using the Add method.
   void addButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      textBox1 = gcnew TextBox;
      panel1->Controls->Add( textBox1 );
   }

// Create a TextBox to add to the Panel.
private TextBox textBox1 = new TextBox();

// Add controls to the Panel using the Add method.
private void addButton_Click(object sender, System.EventArgs e)
{
   panel1.Controls.Add(textBox1);
}

' Create a TextBox to add to the Panel.
Dim TextBox1 As TextBox = New TextBox()

' Add controls to the Panel using the Add method.
Private Sub AddButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles AddButton.Click
    Panel1.Controls.Add(TextBox1)
End Sub

Commenti

Il Add metodo consente di aggiungere Control oggetti alla fine della raccolta di controlli.

È anche possibile aggiungere nuovi Control oggetti alla raccolta usando il AddRange metodo .

Per rimuovere un oggetto Control aggiunto in precedenza, usare i Removemetodi , RemoveAto Clear .

Nota

Un Control può essere assegnato solo a uno Control.ControlCollection alla volta. Se l'oggetto Control è già figlio di un altro controllo, viene rimosso da tale controllo prima che venga aggiunto a un altro controllo.

Note per gli eredi

Quando si esegue l'override Add(Control) in una classe derivata, assicurarsi di chiamare il metodo della Add(Control) classe di base per assicurarsi che il controllo venga aggiunto alla raccolta.

Si applica a

Vedi anche