UserControl.LoadViewState メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

UserControl.LoadViewState メソッド

SaveViewState メソッドによって保存された前回のユーザーコントロール要求からビューステート情報を復元します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Overrides Sub
 LoadViewState ( _
    savedState As Object _
)

Visual Basic (使用法)

Dim savedState As Object

Me.LoadViewState(savedState)

protected override void LoadViewState (
    Object savedState
)

C++

protected:
virtual void LoadViewState (
    Object^ savedState
) override

protected void LoadViewState (
    Object savedState
)

JScript

protected override function LoadViewState (
    savedState : Object
)

パラメータ

savedState: 復元されるユーザーコントロールの状態を表す Object。

解説

通常、このメソッドを呼び出す必要はありません。ただし、ビューステートにカスタム情報を格納している場合は、このメソッドをオーバーライドして情報を復元します。

たとえば、後で Control.ViewState プロパティからビューステート値を取得しなくてもよいように、その値をフィールドに読み込むことができます。また、SaveViewState を呼び出す直前にビューステート値を ViewState プロパティに挿入することもできます。この方法を使用すると、サーバーへのラウンドトリップ全体でフィールドを効率的に永続化できます。

使用例

LoadViewState メソッドと SaveViewState メソッドを使用してビューステートを管理するユーザーコントロールの例を次に示します。

Visual Basic

   
    Public Property UserText() As
 String

        Get
            Return CStr(ViewState("usertext"))
        End Get
        Set(ByVal value As
 String)
            ViewState("usertext") = value
        End Set

    End Property
   
    Public Property PasswordText() As
 String

        Get
            Return CStr(ViewState("passwordtext"))
        End Get
        Set(ByVal value As
 String)
            ViewState("passwordtext") = value
        End Set

    End Property
   
    <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand,
 Name:="FullTrust")> _
    Protected Overrides Sub
 LoadViewState(ByVal savedState As Object)

        Dim totalState As Object()
 = Nothing
        If Not (savedState Is
 Nothing) Then
            totalState = CType(savedState, Object())
            If totalState.Length <> 3 Then
                ' Throw an appropriate exception.
            End If
            ' Load base state.
            MyBase.LoadViewState(totalState(0))
            ' Load extra information specific to this control.
            If Not (totalState Is
 Nothing) AndAlso Not (totalState(1)
 Is Nothing) AndAlso Not (totalState(2) Is Nothing) Then
                UserText = CStr(totalState(1))
                PasswordText = CStr(totalState(2))
            End If
        End If

    End Sub
     
    <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand,
 Name:="FullTrust")> _
    Protected Overrides Function
 SaveViewState() As Object

        Dim baseState As Object
 = MyBase.SaveViewState()
        Dim totalState(2) As Object
        totalState(0) = baseState
        totalState(1) = user.Text
        totalState(2) = password.Text
        Return totalState

    End Function
End Class

public string UserText
{
    get
    {
        return (string)ViewState["usertext"];
    }
    set
    {
        ViewState["usertext"] = value;
    }
}
public string PasswordText
{
    get
    {
        return (string)ViewState["passwordtext"];
    }
    set
    {
        ViewState["passwordtext"] = value;
    }
}

[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand,
 Name="FullTrust")] 
protected override void LoadViewState(object
 savedState) 
{
    object[] totalState = null;       
    if (savedState != null)
    {
        totalState = (object[])savedState;
        if (totalState.Length != 3)
        {
            // Throw an appropriate exception.
        }
        // Load base state.
        base.LoadViewState(totalState[0]);
        // Load extra information specific to this control.
        if (totalState != null && totalState[1]
 != null && totalState[2] != null)
        {
            UserText = (string)totalState[1];
            PasswordText = (string)totalState[2];
        }
    }

}

[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand,
 Name="FullTrust")] 
protected override object SaveViewState()
{
    object baseState = base.SaveViewState();
    object[] totalState = new object[3];
    totalState[0] = baseState;
    totalState[1] = user.Text;
    totalState[2] = password.Text;
    return totalState;
}