Control.ClearChildState Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Usuwa informacje o stanie widoku i stanie kontroli dla wszystkich kontrolek podrzędnych kontrolki serwera.

C#

protected void ClearChildState();

Przykłady

W poniższym przykładzie kodu pokazano, jak zastąpić OnDataBinding metodę dla kontrolki powiązanej z szablonami danych. Jeśli źródło danych powiązane z kontrolką jest wypełniane, kolekcja kontrolki ControlCollection jest opróżniona przy użyciu Clear metody , a ClearChildState metoda służy do usuwania wszelkich informacji o stanie zapisanych dla kontrolek podrzędnych.

C#

// Override to create the repeated items from the DataSource.
protected override void OnDataBinding(EventArgs e) {
    base.OnDataBinding(e);

    if (DataSource != null) {
        // Clear any existing child controls.
        Controls.Clear();
        // Clear any previous state for the existing child controls.
        ClearChildState();

        // Iterate over the DataSource, creating a new item for each data item.
        IEnumerator dataEnum = DataSource.GetEnumerator();
        int i = 0;
        while(dataEnum.MoveNext()) {

            // Create an item.
            RepeaterItem item = new RepeaterItem(i, dataEnum.Current);
            // Initialize the item from the template.
            ItemTemplate.InstantiateIn(item);
            // Add the item to the ControlCollection.
            Controls.Add(item);

            i++;
        }

        // Prevent child controls from being created again.
        ChildControlsCreated = true;
        // Store the number of items created in view state for postback scenarios.
        ViewState["NumItems"] = i;
    }
}

Uwagi

Metoda ClearChildState czyści wszystkie informacje o stanie widoku i stanie kontroli dla kontrolek podrzędnych. Jest ona równoważna wywołaniu metody ClearChildViewState i ClearChildControlState metody .

Podczas ponownego tworzenia kontrolek podrzędnych Control obiektu użyj ClearChildState metody , aby wyczyścić stan podrzędny, aby nie został zastosowany do nowych kontrolek przypadkowo.

Dotyczy

Zobacz też

• ClearChildControlState()
• ClearChildViewState()