Control.EnsureChildControls Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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 false
CreateChildControls 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.