Control.ControlCollection.Add(Control) Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

Control.ControlCollection.cs

Belirtilen denetimi denetim koleksiyonuna ekler.

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)

Parametreler

value

Control

Control denetim koleksiyonuna eklenecek.

Özel durumlar

Exception

Belirtilen denetim bir üst düzey denetimdir veya bu denetim denetim koleksiyonuna eklenirse döngüsel bir denetim başvurusu elde edilir.

ArgumentException

parametresine value atanan nesne bir Controldeğil.

Örnekler

Aşağıdaki kod örneği, türetilmiş sınıfının Controlöğesine bir Control.ControlCollectionPanel ekler. Örnek, üzerinde bir Panel denetim ve bir Button denetim Formoluşturmanızı gerektirir. Düğmeye tıklandığında panelin TextBoxöğesine bir Control.ControlCollection denetim eklenir.

   // 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

Açıklamalar

yöntemi, Add denetim koleksiyonunun sonuna nesne eklemenize Control olanak tanır.

Yöntemini kullanarak Control koleksiyona yeni AddRange nesneler de ekleyebilirsiniz.

Daha önce eklediğiniz bir Control öğesini kaldırmak için , Removeveya RemoveAt yöntemlerini kullanınClear.

Note

bir Control kerede yalnızca bir Control.ControlCollection taneye atanabilir. Control zaten başka bir denetimin alt öğesiyse, başka bir denetime eklenmeden önce bu denetimden kaldırılır.

Devralanlara Notlar

Türetilmiş bir sınıfta geçersiz kılma Add(Control) sırasında, denetimin koleksiyona eklendiğinden emin olmak için temel sınıfın Add(Control) yöntemini çağırdığınızdan emin olun.

Ayrıca bkz.

• Remove(Control)
• RemoveAt(Int32)
• AddRange(Control[])