Control.ControlCollection.Add(Control) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Belirtilen denetimi denetim koleksiyonuna ekler.

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)

Parametreler

value
Control

Control denetim koleksiyonuna eklenecek.

Özel durumlar

Exception

Belirtilen denetim bir üst düzey denetimdir veya bu denetim denetim koleksiyonuna eklendiğinde döngüsel bir denetim başvurusuyla sonuçlanır.

ArgumentException

parametresine value atanan nesne bir Controldeğil.

Örnekler

Aşağıdaki kod örneği türetilmiş sınıfının Panelöğesine bir Control Control.ControlCollection ekler. Örnek, üzerinde bir Panel denetim ve denetim Button Formoluşturmanızı gerektirir. Düğmeye tıklandığında panelin Control.ControlCollectionöğesine bir TextBox 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 AddRange koleksiyona yeni Control nesneler de ekleyebilirsiniz.

Daha önce eklediğiniz bir Control öğesini kaldırmak için , RemoveAtveya Clear yöntemlerini kullanınRemove.

Not

A Control , bir kerede yalnızca bir taneye Control.ControlCollection 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.

Şunlara uygulanır

Ayrıca bkz.