Control.EnsureChildControls Yöntem

Tanım

Ad Alanı:

System.Web.UI

Bütünleştirilmiş Kod:

System.Web.dll

Sunucu denetiminin alt denetimler içerip içermediğini belirler. Aksi takdirde alt denetimler oluşturur.

protected:
 virtual void EnsureChildControls();

protected virtual void EnsureChildControls ();

abstract member EnsureChildControls : unit -> unit
override this.EnsureChildControls : unit -> unit

Protected Overridable Sub EnsureChildControls ()

Örnekler

Aşağıdaki örnek, geçerli sunucu denetiminin alt denetimlere sahip olduğundan emin olmak için yöntemini kullanır EnsureChildControls . Ardından geçerli sunucu ControlCollection denetiminin nesnesindeki alt TextBox Web denetimi için bir Text özellik alır veya ayarlar.

Önemli

Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz. Betik Açıklarına Genel Bakış.

// Ensure the current control has children,
// then get or set the Text property.
 public int Value {
    get {
        this.EnsureChildControls();
        return Int32.Parse(((TextBox)Controls[1]).Text);
    }
    set {
        this.EnsureChildControls();
        ((TextBox)Controls[1]).Text = value.ToString();
    }
 }

' Ensure the current control has children,
' then get or set the Text property.

Public Property Value() As Integer
   Get
      Me.EnsureChildControls()
      Return Int32.Parse(CType(Controls(1), TextBox).Text)
   End Get
   Set
      Me.EnsureChildControls()
      CType(Controls(1), TextBox).Text = value.ToString()
   End Set
End Property

Açıklamalar

Bu yöntem önce özelliğin geçerli değerini ChildControlsCreated denetler. Bu değer ise falseCreateChildControls yöntemi çağrılır.

EnsureChildControls yöntemi genellikle işlevleri için alt denetimleri kullanan denetimler olan bileşik denetimlerde kullanılır. Alt EnsureChildControls denetimlerin oluşturulduğundan ve girişi işlemeye hazır olduğundan emin olmak, veri bağlamayı gerçekleştirmek veya diğer görevleri gerçekleştirmek için yöntemi çağrılır.

Denetim GridView , bileşik denetim örneğidir. Oluşturduğu HTML tablosunu GridView işlemek için kullanılan , TableRowTableCell, , Labelve TextBox denetimleri gibi Tablealt denetimler oluşturur.

Çoğu durumda, özel sunucu denetimi geliştiricilerinin bu yöntemi geçersiz kılması gerekmez. Bu yöntemi geçersiz kılarsanız, bunu varsayılan davranışa benzer bir şekilde kullanın.

Ayrıca bkz.

• Controls
• ChildControlsCreated
• CreateChildControls()