Control.EnsureChildControls Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Avgör om serverkontrollen innehåller underordnade kontroller. Om den inte gör det skapar den underordnade kontroller.
protected:
virtual void EnsureChildControls();protected virtual void EnsureChildControls();abstract member EnsureChildControls : unit -> unit
override this.EnsureChildControls : unit -> unitProtected Overridable Sub EnsureChildControls ()Exempel
I följande exempel används EnsureChildControls metoden för att säkerställa att den aktuella serverkontrollen har underordnade kontroller. Den hämtar eller anger sedan en Text egenskap för en underordnad TextBox webbkontroll i den aktuella serverkontrollens ControlCollection objekt.
Important
Det här exemplet har en textruta som accepterar användarindata, vilket är ett potentiellt säkerhetshot. Som standard kontrollerar ASP.NET webbsidor att användarindata inte innehåller skript- eller HTML-element. Mer information finns i Översikt över skriptexploateringar.
// 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
Kommentarer
Den här metoden kontrollerar först det aktuella värdet för ChildControlsCreated egenskapen. Om det här värdet är falseanropas CreateChildControls metoden.
Metoden EnsureChildControls används vanligtvis i sammansatta kontroller, som är kontroller som använder underordnade kontroller för vissa eller alla deras funktioner. Metoden EnsureChildControls anropas för att se till att underordnade kontroller har skapats och är redo att bearbeta indata, utföra databindning eller utföra andra uppgifter.
Kontrollen GridView är ett exempel på en sammansatt kontroll. Den skapar underordnade kontroller som Table, TableRow, TableCell, Labeloch TextBox kontroller, som används för att återge HTML-tabellen som GridView genereras.
I de flesta fall behöver utvecklare av anpassad serverkontroll inte åsidosätta den här metoden. Om du åsidosätter den här metoden använder du den på ett sätt som liknar standardbeteendet.
