SessionStateSection クラス
アセンブリ: System.Web (system.web.dll 内)


SessionStateSection クラスは、Machine.config または Web.config の各構成ファイル内の sessionState タグで識別される要素を参照します。
新しいクライアントが Web アプリケーションとの対話を開始すると、セッション ID が発行され、この ID と、そのセッションが有効な間に発生する同じクライアントからの以降のすべての要求とが関連付けられます。この ID は、クライアント セッションに関連付けられているサーバー側の状態を維持するために、すべての要求において使用されます。SessionStateSection は、ASP.NET アプリケーションが、各クライアントに代わって、この関連付けをどのように確立して維持するかを制御します。
このメカニズムはきわめて柔軟性が高いため、セッション状態情報をプロセス外にホストし、Cookie を使用しないで状態を追跡するなどの処理を実行できます。

このセクションには、2 つのコード例が用意されています。最初の例では、sessionState セクションの複数の属性に対して、宣言によって値を指定する方法を示しています。これらの属性には、SessionStateSection クラスのメンバとしてもアクセスできます。2 番目の例では、T:System.Web.Configuration.SessionStateSection クラスの使用方法を示します。
次の構成ファイルの例では、sessionState セクションに対して、宣言によって値を指定する方法を示します。
<configuration> <system.web> <sessionState mode="InProc" stateConnectionString="tcpip=127.0.0.1:42424" stateNetworkTimeout="10" sqlConnectionString="data source=127.0.0.1; Integrated Security=SSPI" sqlCommandTimeout="30" customProvider="" cookieless="UseDeviceProfile" cookieName="ASP.NET_SessionId" timeout="20" allowCustomSqlDatabase="False" regenerateExpiredSessionId="False" partitionResolverType="" useHostingIdentity="True"> <providers> <clear /> </providers> </sessionState> </system.web> </configuration>
T:System.Web.Configuration.SessionStateSection クラスの使用方法を次のコード例に示します。
' Get the Web application configuration. Dim configuration As System.Configuration.Configuration = _ System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/aspnetTest") ' Get the section. Dim sessionStateSection As System.Web.Configuration.SessionStateSection = _ CType(configuration.GetSection("system.web/sessionState"), _ System.Web.Configuration.SessionStateSection)
// Get the Web application configuration object. System.Configuration.Configuration configuration = System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/aspnetTest"); // Get the section related object. System.Web.Configuration.SessionStateSection sessionStateSection = (System.Web.Configuration.SessionStateSection) configuration.GetSection("system.web/sessionState");

System.Configuration.ConfigurationElement
System.Configuration.ConfigurationSection
System.Web.Configuration.SessionStateSection


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


SessionStateSection コンストラクタ
アセンブリ: System.Web (system.web.dll 内)


SessionStateSection コンストラクタは、コードで直接使用するためのものではありません。ASP.NET 構成システムによって呼び出されます。SessionStateSection クラスのインスタンスは、GetSection メソッドを使用して取得します。

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


SessionStateSection プロパティ

名前 | 説明 | |
---|---|---|
![]() | AllowCustomSqlDatabase | ユーザーが SqlConnectionString プロパティの初期カタログ値を指定できるかどうかを示す値を取得または設定できます。 |
![]() | Cookieless | クライアント セッションを識別するのに Cookie を使用するかどうかを示す値を取得または設定します。 |
![]() | CookieName | Cookie 名を取得または設定します。 |
![]() | CustomProvider | Providers コレクション内のカスタム プロバイダ名を取得または設定します。 |
![]() | ElementInformation | ConfigurationElement オブジェクトのカスタマイズできない情報と機能を格納する ElementInformation オブジェクトを取得します。 ( ConfigurationElement から継承されます。) |
![]() | LockAllAttributesExcept | ロックされている属性のコレクションを取得します。 ( ConfigurationElement から継承されます。) |
![]() | LockAllElementsExcept | ロックされている要素のコレクションを取得します。 ( ConfigurationElement から継承されます。) |
![]() | LockAttributes | ロックされている属性のコレクションを取得します。 ( ConfigurationElement から継承されます。) |
![]() | LockElements | ロックされている要素のコレクションを取得します。 ( ConfigurationElement から継承されます。) |
![]() | LockItem | 要素がロックされているかどうかを示す値を取得または設定します。 ( ConfigurationElement から継承されます。) |
![]() | Mode | セッション状態の格納場所を指定する値を取得または設定します。 |
![]() | PartitionResolverType | セッション状態の格納場所を指定する値を取得または設定します。 |
![]() | Providers | 現在の ProviderSettingsCollection プロバイダを取得します。 |
![]() | RegenerateExpiredSessionId | 有効期限が切れたセッション ID がクライアントによって指定されている場合に、セッション ID を再発行するかどうかを示す値を取得または設定します。 |
![]() | SectionInformation | ConfigurationSection オブジェクトのカスタマイズできない情報と機能を格納する SectionInformation オブジェクトを取得します。 ( ConfigurationSection から継承されます。) |
![]() | SessionIDManagerType | セッション ID マネージャの完全修飾型を指定する値を取得または設定します。 |
![]() | SqlCommandTimeout | SQL Server セッション状態モードを使用する SQL コマンドのタイムアウト期限を取得または設定します。 |
![]() | SqlConnectionString | SQL 接続文字列を取得または設定します。 |
![]() | StateConnectionString | 状態サーバー接続文字列を取得または設定します。 |
![]() | StateNetworkTimeout | Web サーバーと状態サーバー間のネットワーク接続がアイドルでいられる時間を取得または設定します。 |
![]() | Timeout | セッションのタイムアウトを取得または設定します。 |
![]() | UseHostingIdentity | セッション状態がクライアントの偽装を使用するか (利用可能な場合)、常にホスト ID に戻るかを指定する値を取得または設定します。 |

名前 | 説明 | |
---|---|---|
![]() | ElementProperty | ConfigurationElement オブジェクト自体を表す ConfigurationElementProperty オブジェクトを取得します。 ( ConfigurationElement から継承されます。) |
![]() | EvaluationContext | ConfigurationElement オブジェクトの ContextInformation オブジェクトを取得します。 ( ConfigurationElement から継承されます。) |
![]() | Item | オーバーロードされます。 この ConfigurationElement オブジェクトのプロパティ、属性、または子要素を取得または設定します。 ( ConfigurationElement から継承されます。) |
![]() | Properties | プロパティのコレクションを取得します。 ( ConfigurationElement から継承されます。) |

SessionStateSection メソッド

名前 | 説明 | |
---|---|---|
![]() | Equals | オーバーロードされます。 現在の ConfigurationElement インスタンスを、指定したオブジェクトと比較します。 ( ConfigurationElement から継承されます。) |
![]() | GetHashCode | 現在の ConfigurationElement インスタンスを表す一意の値を取得します。 ( ConfigurationElement から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
![]() | IsReadOnly | ConfigurationElement オブジェクトが読み取り専用かどうかを示す値を取得します。 ( ConfigurationElement から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | DeserializeElement | 構成ファイルから XML を読み取ります。 ( ConfigurationElement から継承されます。) |
![]() | DeserializeSection | 構成ファイルから XML を読み取ります。 ( ConfigurationSection から継承されます。) |
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
![]() | GetRuntimeObject | 派生クラスでオーバーライドされると、カスタム オブジェクトを返します。 ( ConfigurationSection から継承されます。) |
![]() | Init | ConfigurationElement オブジェクトを初期状態に設定します。 ( ConfigurationElement から継承されます。) |
![]() | InitializeDefault | ConfigurationElement オブジェクトの既定の値セットを初期化するために使用します。 ( ConfigurationElement から継承されます。) |
![]() | IsModified | 派生クラスに実装された場合、この構成要素が最後の保存または読み込み以降に変更されたかどうかを示します。 ( ConfigurationSection から継承されます。) |
![]() | ListErrors | この ConfigurationElement オブジェクトおよびすべてのサブ要素の無効なプロパティのエラーを、渡されたリストに追加します。 ( ConfigurationElement から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
![]() | OnDeserializeUnrecognizedAttribute | 逆シリカル化中に不明な属性が発生したかどうかを示す値を取得します。 ( ConfigurationElement から継承されます。) |
![]() | OnDeserializeUnrecognizedElement | 逆シリカル化中に不明な要素が発生したかどうかを示す値を取得します。 ( ConfigurationElement から継承されます。) |
![]() | OnRequiredPropertyNotFound | 必須プロパティが見つからなかったかどうかを示す値を取得します。 ( ConfigurationElement から継承されます。) |
![]() | PostDeserialize | 逆シリアル化後に呼び出されます。 ( ConfigurationElement から継承されます。) |
![]() | PreSerialize | シリアル化前に呼び出されます。 ( ConfigurationElement から継承されます。) |
![]() | Reset | ConfigurationElement オブジェクトの内部状態 (ロックやプロパティ コレクションなど) をリセットします。 ( ConfigurationElement から継承されます。) |
![]() | ResetModified | 派生クラスに実装された場合、IsModified メソッドの値を false にリセットします。 ( ConfigurationSection から継承されます。) |
![]() | SerializeElement | 派生クラスに実装されている場合、この構成要素の内容を構成ファイルに書き込みます。 ( ConfigurationElement から継承されます。) |
![]() | SerializeSection | ファイルに書き込む 1 つのセクションとして、ConfigurationSection オブジェクトのアンマージされたビューを含む XML 文字列を作成します。 ( ConfigurationSection から継承されます。) |
![]() | SerializeToXmlElement | 派生クラスに実装されている場合、この構成要素の外側のタグを構成ファイルに書き込みます。 ( ConfigurationElement から継承されます。) |
![]() | SetPropertyValue | プロパティを指定した値に設定します。 ( ConfigurationElement から継承されます。) |
![]() | SetReadOnly | ConfigurationElement オブジェクトおよびすべてのサブ要素に IsReadOnly プロパティを設定します。 ( ConfigurationElement から継承されます。) |
![]() | Unmerge | 保存しないすべての値を削除するには、ConfigurationElement オブジェクトを変更します。 ( ConfigurationElement から継承されます。) |

SessionStateSection メンバ
SessionStateSection データ型で公開されるメンバを以下の表に示します。


名前 | 説明 | |
---|---|---|
![]() | AllowCustomSqlDatabase | ユーザーが SqlConnectionString プロパティの初期カタログ値を指定できるかどうかを示す値を取得または設定できます。 |
![]() | Cookieless | クライアント セッションを識別するのに Cookie を使用するかどうかを示す値を取得または設定します。 |
![]() | CookieName | Cookie 名を取得または設定します。 |
![]() | CustomProvider | Providers コレクション内のカスタム プロバイダ名を取得または設定します。 |
![]() | ElementInformation | ConfigurationElement オブジェクトのカスタマイズできない情報と機能を格納する ElementInformation オブジェクトを取得します。 (ConfigurationElement から継承されます。) |
![]() | LockAllAttributesExcept | ロックされている属性のコレクションを取得します。(ConfigurationElement から継承されます。) |
![]() | LockAllElementsExcept | ロックされている要素のコレクションを取得します。(ConfigurationElement から継承されます。) |
![]() | LockAttributes | ロックされている属性のコレクションを取得します。 (ConfigurationElement から継承されます。) |
![]() | LockElements | ロックされている要素のコレクションを取得します。(ConfigurationElement から継承されます。) |
![]() | LockItem | 要素がロックされているかどうかを示す値を取得または設定します。(ConfigurationElement から継承されます。) |
![]() | Mode | セッション状態の格納場所を指定する値を取得または設定します。 |
![]() | PartitionResolverType | セッション状態の格納場所を指定する値を取得または設定します。 |
![]() | Providers | 現在の ProviderSettingsCollection プロバイダを取得します。 |
![]() | RegenerateExpiredSessionId | 有効期限が切れたセッション ID がクライアントによって指定されている場合に、セッション ID を再発行するかどうかを示す値を取得または設定します。 |
![]() | SectionInformation | ConfigurationSection オブジェクトのカスタマイズできない情報と機能を格納する SectionInformation オブジェクトを取得します。 (ConfigurationSection から継承されます。) |
![]() | SessionIDManagerType | セッション ID マネージャの完全修飾型を指定する値を取得または設定します。 |
![]() | SqlCommandTimeout | SQL Server セッション状態モードを使用する SQL コマンドのタイムアウト期限を取得または設定します。 |
![]() | SqlConnectionString | SQL 接続文字列を取得または設定します。 |
![]() | StateConnectionString | 状態サーバー接続文字列を取得または設定します。 |
![]() | StateNetworkTimeout | Web サーバーと状態サーバー間のネットワーク接続がアイドルでいられる時間を取得または設定します。 |
![]() | Timeout | セッションのタイムアウトを取得または設定します。 |
![]() | UseHostingIdentity | セッション状態がクライアントの偽装を使用するか (利用可能な場合)、常にホスト ID に戻るかを指定する値を取得または設定します。 |

名前 | 説明 | |
---|---|---|
![]() | ElementProperty | ConfigurationElement オブジェクト自体を表す ConfigurationElementProperty オブジェクトを取得します。(ConfigurationElement から継承されます。) |
![]() | EvaluationContext | ConfigurationElement オブジェクトの ContextInformation オブジェクトを取得します。(ConfigurationElement から継承されます。) |
![]() | Item | オーバーロードされます。 この ConfigurationElement オブジェクトのプロパティ、属性、または子要素を取得または設定します。(ConfigurationElement から継承されます。) |
![]() | Properties | プロパティのコレクションを取得します。(ConfigurationElement から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Equals | オーバーロードされます。 現在の ConfigurationElement インスタンスを、指定したオブジェクトと比較します。 (ConfigurationElement から継承されます。) |
![]() | GetHashCode | 現在の ConfigurationElement インスタンスを表す一意の値を取得します。 (ConfigurationElement から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
![]() | IsReadOnly | ConfigurationElement オブジェクトが読み取り専用かどうかを示す値を取得します。 (ConfigurationElement から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | DeserializeElement | 構成ファイルから XML を読み取ります。 (ConfigurationElement から継承されます。) |
![]() | DeserializeSection | 構成ファイルから XML を読み取ります。 (ConfigurationSection から継承されます。) |
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
![]() | GetRuntimeObject | 派生クラスでオーバーライドされると、カスタム オブジェクトを返します。 (ConfigurationSection から継承されます。) |
![]() | Init | ConfigurationElement オブジェクトを初期状態に設定します。 (ConfigurationElement から継承されます。) |
![]() | InitializeDefault | ConfigurationElement オブジェクトの既定の値セットを初期化するために使用します。 (ConfigurationElement から継承されます。) |
![]() | IsModified | 派生クラスに実装された場合、この構成要素が最後の保存または読み込み以降に変更されたかどうかを示します。 (ConfigurationSection から継承されます。) |
![]() | ListErrors | この ConfigurationElement オブジェクトおよびすべてのサブ要素の無効なプロパティのエラーを、渡されたリストに追加します。 (ConfigurationElement から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
![]() | OnDeserializeUnrecognizedAttribute | 逆シリカル化中に不明な属性が発生したかどうかを示す値を取得します。 (ConfigurationElement から継承されます。) |
![]() | OnDeserializeUnrecognizedElement | 逆シリカル化中に不明な要素が発生したかどうかを示す値を取得します。 (ConfigurationElement から継承されます。) |
![]() | OnRequiredPropertyNotFound | 必須プロパティが見つからなかったかどうかを示す値を取得します。 (ConfigurationElement から継承されます。) |
![]() | PostDeserialize | 逆シリアル化後に呼び出されます。 (ConfigurationElement から継承されます。) |
![]() | PreSerialize | シリアル化前に呼び出されます。 (ConfigurationElement から継承されます。) |
![]() | Reset | ConfigurationElement オブジェクトの内部状態 (ロックやプロパティ コレクションなど) をリセットします。 (ConfigurationElement から継承されます。) |
![]() | ResetModified | 派生クラスに実装された場合、IsModified メソッドの値を false にリセットします。 (ConfigurationSection から継承されます。) |
![]() | SerializeElement | 派生クラスに実装されている場合、この構成要素の内容を構成ファイルに書き込みます。 (ConfigurationElement から継承されます。) |
![]() | SerializeSection | ファイルに書き込む 1 つのセクションとして、ConfigurationSection オブジェクトのアンマージされたビューを含む XML 文字列を作成します。 (ConfigurationSection から継承されます。) |
![]() | SerializeToXmlElement | 派生クラスに実装されている場合、この構成要素の外側のタグを構成ファイルに書き込みます。 (ConfigurationElement から継承されます。) |
![]() | SetPropertyValue | プロパティを指定した値に設定します。 (ConfigurationElement から継承されます。) |
![]() | SetReadOnly | ConfigurationElement オブジェクトおよびすべてのサブ要素に IsReadOnly プロパティを設定します。 (ConfigurationElement から継承されます。) |
![]() | Unmerge | 保存しないすべての値を削除するには、ConfigurationElement オブジェクトを変更します。 (ConfigurationElement から継承されます。) |

- SessionStateSectionのページへのリンク