Control.ClearChildState 메서드

정의

네임스페이스:

System.Web.UI

어셈블리:

System.Web.dll

서버 컨트롤의 모든 자식 컨트롤에 대한 뷰 상태 정보와 컨트롤 상태 정보를 삭제합니다.

protected:
 void ClearChildState();

protected void ClearChildState ();

member this.ClearChildState : unit -> unit

Protected Sub ClearChildState ()

예제

다음 코드 예제에서는 템플릿 데이터 바인딩된 컨트롤에 OnDataBinding 대 한 메서드를 재정의 하는 방법을 보여 줍니다. 컨트롤이 바인딩하는 데이터 원본이 채워지면 메서드를 사용하여 Clear 컨트롤의 ControlCollection 컬렉션이 비워지고 ClearChildState 자식 컨트롤에 대해 저장된 상태 정보를 제거하는 데 메서드가 사용됩니다.

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

' Override to create the repeated items from the DataSource.
Protected Overrides Sub OnDataBinding(E As EventArgs)
    MyBase.OnDataBinding(e)

    If Not DataSource Is Nothing
        ' Clear any existing child controls.
        Controls.Clear()
        ' Clear any previous view state for the existing child controls.
        ClearChildState()

        ' Iterate over the DataSource, creating a new item for each data item.
        Dim DataEnum As IEnumerator = DataSource.GetEnumerator()
        Dim I As Integer = 0
        Do While (DataEnum.MoveNext())

            ' Create an item.
            Dim Item As RepeaterItemVB = New RepeaterItemVB(I, DataEnum.Current)
            ' Initialize the item from the template.
            ItemTemplate.InstantiateIn(Item)
            ' Add the item to the ControlCollection.
            Controls.Add(Item)

            I = I + 1
        Loop

        ' Prevent child controls from being created again.
        ChildControlsCreated = true
        ' Store the number of items created in view state for postback scenarios.
        ViewState("NumItems") = I
    End If
End Sub

설명

이 메서드는 ClearChildState 자식 컨트롤에 대한 모든 뷰 상태 및 컨트롤 상태 정보를 지웁니다. 메서드와 메서드를 모두 호출하는 ClearChildViewState ClearChildControlState 것과 같습니다.

개체의 Control 자식 컨트롤을 다시 만들 때 메서드를 사용하여 ClearChildState 새 컨트롤에 실수로 적용되지 않도록 자식 상태를 지웁니다.

추가 정보

• ClearChildControlState()
• ClearChildViewState()