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 EnsureChildControls alt denetimlere sahip olduğundan emin olmak için yöntemini kullanır. Ardından geçerli sunucu ControlCollection denetiminin nesnesinde 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. yöntemi EnsureChildControls , alt denetimlerin oluşturulduğundan ve girişi işlemeye, veri bağlamayı gerçekleştirmeye veya diğer görevleri gerçekleştirmeye hazır olduğundan emin olmak için çağrılır.
Denetim GridView , bileşik denetim örneğidir. Oluşturduğu HTML tablosunu GridView işlemek için kullanılan , TableRowTableCell, , Label, ve TextBox denetimleri gibi Tablealt denetimler oluşturur.
Çoğu durumda, özel sunucu denetimi geliştiricilerinin bu yöntemi geçersiz kılmaları gerekmez. Bu yöntemi geçersiz kılarsanız, bunu varsayılan davranışa benzer bir şekilde kullanın.