Control.EnsureChildControls Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne.

protected:
 virtual void EnsureChildControls();
protected virtual void EnsureChildControls ();
abstract member EnsureChildControls : unit -> unit
override this.EnsureChildControls : unit -> unit
Protected Overridable Sub EnsureChildControls ()

Przykłady

W poniższym przykładzie EnsureChildControls użyto metody , aby upewnić się, że bieżąca kontrolka serwera ma kontrolki podrzędne. Następnie pobiera lub ustawia Text właściwość podrzędnej TextBox kontrolki sieci Web w obiekcie bieżącego formantu ControlCollection serwera.

Ważne

W tym przykładzie znajduje się pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web weryfikują, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Omówienie luk w zabezpieczeniach skryptów.

// 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

Uwagi

Ta metoda najpierw sprawdza bieżącą wartość ChildControlsCreated właściwości. Jeśli ta wartość to false, wywoływana CreateChildControls jest metoda .

Metoda EnsureChildControls jest zwykle używana w kontrolkach złożonych, które są kontrolkami, które używają kontrolek podrzędnych dla niektórych lub wszystkich ich funkcji. Metoda jest wywoływana EnsureChildControls w celu upewnienia się, że kontrolki podrzędne zostały utworzone i są gotowe do przetwarzania danych wejściowych, wykonywania powiązania danych lub wykonywania innych zadań.

Kontrolka GridView jest przykładem kontrolki złożonej. Tworzy kontrolki podrzędne, takie jak Table, , TableRowTableCell, LabeliTextBox, które są używane do renderowania tabeli HTML generowanej GridView przez program .

W większości przypadków deweloperzy kontroli serwera niestandardowego nie muszą zastąpić tej metody. Jeśli zastąpisz tę metodę, użyj jej w sposób podobny do domyślnego zachowania.

Dotyczy

Zobacz też