ViewStateException クラス

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

ViewStateException クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ビューステートの読み込みまたは検証ができない場合にスローされる例外を表します。このクラスは継承できません。

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

Visual Basic (宣言)

<SerializableAttribute> _
Public NotInheritable Class
 ViewStateException
    Inherits Exception
    Implements ISerializable

Visual Basic (使用法)

Dim instance As ViewStateException

C#

[SerializableAttribute] 
public sealed class ViewStateException : Exception,
 ISerializable

C++

[SerializableAttribute] 
public ref class ViewStateException sealed
 : public Exception, ISerializable

J#

/** @attribute SerializableAttribute() */ 
public final class ViewStateException extends
 Exception implements ISerializable

JScript

SerializableAttribute 
public final class ViewStateException extends
 Exception implements ISerializable

解説

ページにビューステート情報が読み込まれるときに例外が発生した場合、ViewStateException オブジェクトが作成され、HttpException 例外内の内部例外として渡されます。HttpException 例外は再スローされ、アプリケーションにより処理されます。

ViewStateException クラスは、Message プロパティの例外に関する情報を格納します。ServerVariables プロパティにアクセスするためのアクセス許可を要求が持っている場合、Message プロパティには、RemoteAddress、RemotePort、UserAgent、PersistedState、Referer、および Path の各プロパティから返された値が設定されます。それ以外の場合、Message プロパティには一般的なビューステート エラー メッセージが設定されます。

ビューステート例外は、メッセージ認証コード (MAC: Message Authentication Code) 検証エラーの結果である場合があります。ページの enableViewStateMac 属性が true に設定されている場合、ビューステート情報は MAC 識別子を使用してエンコードされます。ビューステート情報がサーバーにポストバックされると、ページではエンコーディングを検証して、ユーザーによって変更されていないことを確認します。ビューステート情報の MAC エンコーディングを検証できない場合、内部例外として ViewStateException を指定した HttpException 例外をページがスローします。

MAC 検証が成功するには、送信時と受信時に同じキーを使ってビューステート情報をハッシュする必要があります。Web ファーム内では、各サーバーのマシン キーを共通キーに設定する必要があります。

使用例

base64 エンコードされた文字列を逆シリアル化して、プロパティ設定の ICollection コレクションを返すメソッドの実装方法を次のコード例で示します。Deserialize メソッドは、ViewStateException オブジェクトを内部例外として持つ HttpException 例外をスローできます。この例では、HttpException 例外をキャッチして、ViewStateException オブジェクトからプロパティを取得する方法を示します。

Visual Basic

Private Function LoadControlProperties(ByVal
 serializedProperties As String) As
 ICollection

    Dim controlProperties As ICollection =
 Nothing

    ' Create an ObjectStateFormatter to deserialize the properties.
    Dim formatter As New
 ObjectStateFormatter()

    Try
        ' Call the Deserialize method.
        controlProperties = CType(formatter.Deserialize(serializedProperties), ArrayList)
    Catch e As HttpException
        Dim vse As ViewStateException
        Dim logMessage As String

        vse = e.InnerException

        logMessage = "ViewStateException. Path: "
 + vse.Path + Environment.NewLine
        logMessage += "PersistedState: " + vse.PersistedState
 + Environment.NewLine
        logMessage += "Referer: " + vse.Referer +
 Environment.NewLine
        logMessage += "UserAgent: " + vse.UserAgent
 + Environment.NewLine

        LogEvent(logMessage)

        If (vse.IsConnected) Then
            HttpContext.Current.Response.Redirect("ErrorPage.aspx")
        Else
            Throw e
        End If
    End Try
    Return controlProperties
End Function 'LoadControlProperties
   

C#

private ICollection LoadControlProperties(string
 serializedProperties)
{

    ICollection controlProperties = null;

    // Create an ObjectStateFormatter to deserialize the properties.
    ObjectStateFormatter formatter = new ObjectStateFormatter();

    try
    {
        // Call the Deserialize method.
        controlProperties = (ArrayList)formatter.Deserialize(serializedProperties);
    }
    catch (HttpException e)
    {
        ViewStateException vse = (ViewStateException)e.InnerException;
        String logMessage;

        logMessage = "ViewStateException. Path: " + vse.Path + Environment.NewLine;
        logMessage += "PersistedState: " + vse.PersistedState + Environment.NewLine;
        logMessage += "Referer: " + vse.Referer + Environment.NewLine;
        logMessage += "UserAgent: " + vse.UserAgent + Environment.NewLine;

        LogEvent(logMessage);

        if (vse.IsConnected)
        {
            HttpContext.Current.Response.Redirect("ErrorPage.aspx");
        }
        else
        {
            throw e;
        }
    }
    return controlProperties;
}

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)。Minimal (関連する列挙体)

継承階層

System.Object
   System.Exception
    System.Web.UI.ViewStateException

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ViewStateException メンバ
System.Web.UI 名前空間
MachineKeySection
その他の技術情報
@ Page