Control.ViewState 속성

정의

같은 페이지에 대한 여러 개의 요청 전반에 서버 컨트롤의 뷰 상태를 저장하고 복원할 수 있도록 하는 상태 정보 사전을 가져옵니다.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

protected:
 virtual property System::Web::UI::StateBag ^ ViewState { System::Web::UI::StateBag ^ get(); };
[System.ComponentModel.Browsable(false)]
protected virtual System.Web.UI.StateBag ViewState { get; }
member this.ViewState : System.Web.UI.StateBag
Protected Overridable ReadOnly Property ViewState As StateBag

속성 값

서버 컨트롤의 뷰 상태 정보가 들어 있는 StateBag 클래스의 인스턴스입니다.An instance of the StateBag class that contains the server control's view-state information.

특성

예제

다음 예제에서는 컨트롤의 ViewState 속성에서 해당 값을 저장 하 고 검색 하는 Text 속성을 구현 하는 방법을 보여 줍니다.The following example demonstrates implementing a Text property that stores and retrieves its value from its control's ViewState property.

// Add property values to view state with set;
// retrieve them from view state with get.
public String Text
{
    get 
    { 
        object o = ViewState["Text"]; 
        return (o == null)? String.Empty : (string)o;
    }

    set
    {
        ViewState["Text"] = value;
    }
}

' Add property values to view state with set; 
' retrieve them from view state with get.
Public Property [Text]() As String
    Get
        Dim o As Object = ViewState("Text")
        If (IsNothing(o)) Then
            Return String.Empty
        Else
            Return CStr(o)
        End If
    End Get
    Set(ByVal value As String)
        ViewState("Text") = value
    End Set
End Property

설명

서버 컨트롤의 뷰 상태는 모든 속성 값의 누적 된 것입니다.A server control's view state is the accumulation of all its property values. HTTP 요청에서 이러한 값을 유지 하기 위해 ASP.NET 서버 컨트롤은 StateBag 클래스 인스턴스인이 속성을 사용 하 여 속성 값을 저장 합니다.In order to preserve these values across HTTP requests, ASP.NET server controls use this property, which is an instance of the StateBag class, to store the property values. 그런 다음이 값은 후속 요청이 처리 될 때 HTML 숨겨진된 input 요소를 변수로 전달 됩니다.The values are then passed as a variable to an HTML hidden input element when subsequent requests are processed. 서버 컨트롤의 뷰 상태를 저장 하는 방법에 대 한 자세한 내용은 참조 하세요. ASP.NET 상태 관리 개요합니다.For more information about saving server control view state, see ASP.NET State Management Overview.

기본적으로 모든 서버 컨트롤의 보기 상태 사용 하지만 비활성화 하려고 있는 경우도 있습니다.View state is enabled for all server controls by default, but there are circumstances in which you will want to disable it. 자세한 내용은 ASP.NET 성능 개요합니다.For more information, see ASP.NET Performance Overview.

사전 및 사용 하는 방법에 대 한 정보를 참조 하세요 컬렉션 및 데이터 구조합니다.For information about dictionaries and how to use them, see Collections and Data Structures.

적용 대상

추가 정보