StateItem クラス
アセンブリ: System.Web (system.web.dll 内)
ビューステートはページまたは ASP.NET サーバー コントロールのプロパティ値の累積であり、要求側のブラウザの非表示フィールドに送信されます。
Item プロパティまたは Add メソッドを使用して、StateItem オブジェクトを ASP.NET サーバー コントロールの StateBag オブジェクトに明示的に追加できます。その後 StateBag は、格納しているすべての項目への変更を追跡します。StateItem オブジェクトに対する変更は、IsDirty プロパティに反映されます。これらの変更は、サーバー コントロール処理のビューステート保存フェーズ中に、コントロールがページに表示される前に SaveViewState メソッドへの呼び出しによって保存されます。詳細については、「ASP.NET Web サーバー コントロール」を参照してください。
StateItem クラスの Value プロパティと IsDirty プロパティを使用して、シンプルなカスタム ASP.NET サーバー コントロール クラス (FirstCustomControl) の状態を保存する方法を次のコード例に示します。ページがサーバーにポストされると、IsDirty プロパティによって、項目が変更されたかどうかがチェックされます。この状態の値は、Value プロパティから取得され、表示されます。
' Create a function that iterates through the view-state ' values stored for this class and returns the ' results as a string. Public Function EnumerateViewState() As String Dim keyName, keyValue As String Dim result As String = [String].Empty Dim myStateItem As StateItem Dim myDictionaryEnumerator As IDictionaryEnumerator = _viewstate.GetEnumerator() While myDictionaryEnumerator.MoveNext() keyName = CStr(myDictionaryEnumerator.Key) myStateItem = CType(myDictionaryEnumerator.Value, StateItem) keyValue = CStr(myStateItem.Value) result = result + "<br>ViewState[" + keyName + "] = " + keyValue End While Return result End Function 'EnumerateViewState End Class 'MyItem
// Create a function that iterates through the view-state // values stored for this class and returns the // results as a string. public string EnumerateViewState() { string keyName, keyValue; string result = String.Empty; StateItem myStateItem; IDictionaryEnumerator myDictionaryEnumerator = _viewstate.GetEnumerator(); while (myDictionaryEnumerator.MoveNext()) { keyName = (string)myDictionaryEnumerator.Key; myStateItem = (StateItem)myDictionaryEnumerator.Value; keyValue = (string)myStateItem.Value; result = result + "<br>ViewState[" + keyName + "] = " + keyValue; } return result; }
// Create a function that iterates through the view-state // values stored for this class and returns the // results as a string. public String EnumerateViewState() { String keyName, keyValue; String result = ""; StateItem myStateItem; IDictionaryEnumerator myDictionaryEnumerator = _viewState.GetEnumerator(); while (myDictionaryEnumerator.MoveNext()) { keyName = (String)myDictionaryEnumerator.get_Key(); myStateItem = (StateItem) myDictionaryEnumerator.get_Value(); keyValue = (String)myStateItem.get_Value(); result = result + "<br>ViewState[" + keyName + "] = " + keyValue; } return result; } //EnumerateViewState
System.Web.UI.StateItem
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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
StateItem プロパティ
名前 | 説明 | |
---|---|---|
| IsDirty | StateItem オブジェクトが変更されたかどうかを示す値を取得または設定します。 |
| Value | StateBag オブジェクトに格納されている StateItem オブジェクトの値を取得または設定します。 |
StateItem メソッド
名前 | 説明 | |
---|---|---|
| Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
| GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
| GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
| ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |
名前 | 説明 | |
---|---|---|
| Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
StateItem メンバ
ビューステート情報が複数の Web 要求間で永続化されている場合に、StateBag クラスに保存されている項目を表します。このクラスは継承できません。
StateItem データ型で公開されるメンバを以下の表に示します。
名前 | 説明 | |
---|---|---|
| IsDirty | StateItem オブジェクトが変更されたかどうかを示す値を取得または設定します。 |
| Value | StateBag オブジェクトに格納されている StateItem オブジェクトの値を取得または設定します。 |
名前 | 説明 | |
---|---|---|
| Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
| GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
| GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
| ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
| ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |
名前 | 説明 | |
---|---|---|
| Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
| MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
- StateItemのページへのリンク