SessionStateSection クラス

定義

名前空間:

System.Web.Configuration

アセンブリ:

System.Web.dll

Web アプリケーションのセッション状態を構成します。

public ref class SessionStateSection sealed : System::Configuration::ConfigurationSection

public sealed class SessionStateSection : System.Configuration.ConfigurationSection

type SessionStateSection = class
    inherit ConfigurationSection

Public NotInheritable Class SessionStateSection
Inherits ConfigurationSection

継承

Object

ConfigurationElement

ConfigurationSection

SessionStateSection

例

このセクションでは、2 つのコード例を示します。 1 つ目は、セクションのいくつかの属性に対して宣言的に値を指定する方法を sessionState 示しています。これは、 クラスの SessionStateSection メンバーとしてアクセスすることもできます。 2 つ目は、 クラスの使用方法を 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>

次のコード例では、 クラスの使用方法 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");

' 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)

注釈

クラスは SessionStateSection 、タグによって識別されるMachine.configまたはWeb.config構成ファイル内の要素を sessionState 参照します。

新しいクライアントが Web アプリケーションとの対話を開始すると、セッション ID が発行され、セッションが有効な間に同じクライアントからの後続のすべての要求に関連付けられます。 この ID は、要求間でクライアント セッションに関連付けられているサーバー側の状態を維持するために使用されます。 は SessionStateSection 、ASP.NET アプリケーションが各クライアントに代わってこの関連付けを確立および維持する方法を制御します。

このメカニズムは非常に柔軟であり、セッション状態情報をプロセス外でホストしたり、Cookie を使用せずに状態を追跡したりすることができます。

コンストラクター

SessionStateSection()

SessionStateSection クラスの新しいインスタンスを初期化します。

プロパティ

AllowCustomSqlDatabase	ユーザーが SqlConnectionString プロパティの初期カタログ値を指定できるかどうかを示す値を取得または設定できます。
CompressionEnabled	セッション状態データで圧縮が有効になっているかどうかを示す値を取得または設定します。
Cookieless	クライアント セッションを識別するのにクッキーを使用するかどうかを示す値を取得または設定します。
CookieName	クッキー名を取得または設定します。
CookieSameSite	Cookie の SameSite 属性の値を取得または設定します。
CurrentConfiguration	現在の Configuration インスタンスが属している構成階層を表す最上位の ConfigurationElement インスタンスへの参照を取得します。 (継承元 ConfigurationElement)
CustomProvider	Providers コレクション内のカスタム プロバイダー名を取得または設定します。
ElementInformation	ElementInformation オブジェクトのカスタマイズできない情報と機能を格納する ConfigurationElement オブジェクトを取得します。 (継承元 ConfigurationElement)
ElementProperty	ConfigurationElementProperty オブジェクト自体を表す ConfigurationElement オブジェクトを取得します。 (継承元 ConfigurationElement)
EvaluationContext	ContextInformation オブジェクトの ConfigurationElement オブジェクトを取得します。 (継承元 ConfigurationElement)
HasContext	CurrentConfiguration プロパティが null であるかどうかを示す値を取得します。 (継承元 ConfigurationElement)
Item[ConfigurationProperty]	この構成要素のプロパティまたは属性を取得または設定します。 (継承元 ConfigurationElement)
Item[String]	この構成要素のプロパティ、属性、または子要素を取得または設定します。 (継承元 ConfigurationElement)
LockAllAttributesExcept	ロックされている属性のコレクションを取得します。 (継承元 ConfigurationElement)
LockAllElementsExcept	ロックされている要素のコレクションを取得します。 (継承元 ConfigurationElement)
LockAttributes	ロックされている属性のコレクションを取得します。 (継承元 ConfigurationElement)
LockElements	ロックされている要素のコレクションを取得します。 (継承元 ConfigurationElement)
LockItem	要素がロックされているかどうかを示す値を取得または設定します。 (継承元 ConfigurationElement)
Mode	セッション状態の格納場所を指定する値を取得または設定します。
PartitionResolverType	セッション状態の格納場所を指定する値を取得または設定します。
Properties	プロパティのコレクションを取得します。 (継承元 ConfigurationElement)
Providers	現在の ProviderSettingsCollection プロバイダーを取得します。
RegenerateExpiredSessionId	有効期限が切れたセッション ID がクライアントによって指定されている場合に、セッション ID を再発行するかどうかを示す値を取得または設定します。
SectionInformation	SectionInformation オブジェクトのカスタマイズできない情報と機能を格納する ConfigurationSection オブジェクトを取得します。 (継承元 ConfigurationSection)
SessionIDManagerType	セッション ID マネージャーの完全修飾型を指定する値を取得または設定します。
SqlCommandTimeout	SQL Server セッション状態モードを使用する SQL コマンドのタイムアウト期限を取得または設定します。
SqlConnectionRetryInterval	ASP.NET がデータベースへの再接続を行うまでの時間間隔を取得または設定します。
SqlConnectionString	SQL 接続文字列を取得または設定します。
StateConnectionString	状態サーバー接続文字列を取得または設定します。
StateNetworkTimeout	Web サーバーと状態サーバー間のネットワーク接続がアイドルでいられる時間を取得または設定します。
Timeout	セッションのタイムアウトを取得または設定します。
UseHostingIdentity	セッション状態がクライアントの偽装を使用するか (利用可能な場合)、常にホスト ID に戻るかを指定する値を取得または設定します。

メソッド

DeserializeElement(XmlReader, Boolean)	構成ファイルから XML を読み取ります。 (継承元 ConfigurationElement)
DeserializeSection(XmlReader)	構成ファイルから XML を読み取ります。 (継承元 ConfigurationSection)
Equals(Object)	現在の ConfigurationElement インスタンスを、指定したオブジェクトと比較します。 (継承元 ConfigurationElement)
GetHashCode()	現在の ConfigurationElement インスタンスを表す一意の値を取得します。 (継承元 ConfigurationElement)
GetRuntimeObject()	派生クラスでオーバーライドされると、カスタム オブジェクトを返します。 (継承元 ConfigurationSection)
GetTransformedAssemblyString(String)	指定されたアセンブリ名を変換して返します。 (継承元 ConfigurationElement)
GetTransformedTypeString(String)	指定された型名を変換して返します。 (継承元 ConfigurationElement)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
Init()	ConfigurationElement オブジェクトを初期状態に設定します。 (継承元 ConfigurationElement)
InitializeDefault()	ConfigurationElement オブジェクトの既定の値セットを初期化するために使用します。 (継承元 ConfigurationElement)
IsModified()	派生クラスに実装された場合、この構成要素が最後の保存または読み込み以降に変更されたかどうかを示します。 (継承元 ConfigurationSection)
IsReadOnly()	ConfigurationElement オブジェクトが読み取り専用かどうかを示す値を取得します。 (継承元 ConfigurationElement)
ListErrors(IList)	この ConfigurationElement オブジェクトおよびすべてのサブ要素の無効なプロパティのエラーを、渡されたリストに追加します。 (継承元 ConfigurationElement)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
OnDeserializeUnrecognizedAttribute(String, String)	逆シリカル化中に不明な属性が発生したかどうかを示す値を取得します。 (継承元 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	逆シリカル化中に不明な要素が発生したかどうかを示す値を取得します。 (継承元 ConfigurationElement)
OnRequiredPropertyNotFound(String)	必要なプロパティが見つからないと例外がスローされます。 (継承元 ConfigurationElement)
PostDeserialize()	逆シリアル化後に呼び出されます。 (継承元 ConfigurationElement)
PreSerialize(XmlWriter)	シリアル化前に呼び出されます。 (継承元 ConfigurationElement)
Reset(ConfigurationElement)	ConfigurationElement オブジェクトの内部状態 (ロックやプロパティ コレクションなど) をリセットします。 (継承元 ConfigurationElement)
ResetModified()	IsModified() メソッドの値が派生クラスに実装されたときに、false にリセットします。 (継承元 ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	派生クラスに実装されている場合、この構成要素の内容を構成ファイルに書き込みます。 (継承元 ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	ファイルに書き込む 1 つのセクションとして、ConfigurationSection オブジェクトのアンマージされたビューを含む XML 文字列を作成します。 (継承元 ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	派生クラスに実装されている場合、この構成要素の外側のタグを構成ファイルに書き込みます。 (継承元 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	プロパティを指定した値に設定します。 (継承元 ConfigurationElement)
SetReadOnly()	IsReadOnly() オブジェクトおよびすべてのサブ要素に ConfigurationElement プロパティを設定します。 (継承元 ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	指定したターゲット バージョンの.NET Frameworkに対して構成オブジェクト階層をシリアル化するときに、指定した要素をシリアル化する必要があるかどうかを示します。 (継承元 ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	指定したターゲット バージョンの.NET Frameworkに対して構成オブジェクト階層をシリアル化するときに、指定したプロパティをシリアル化する必要があるかどうかを示します。 (継承元 ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	指定したターゲット バージョンの.NET Frameworkに対して構成オブジェクト階層をシリアル化するときに、現在ConfigurationSectionのインスタンスをシリアル化する必要があるかどうかを示します。 (継承元 ConfigurationSection)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	保存しないすべての値を削除するには、ConfigurationElement オブジェクトを変更します。 (継承元 ConfigurationElement)

こちらもご覧ください

• HttpContext
• HttpSessionState
• ASP.NET 状態管理の概要
• ASP.NET セッション状態の概要
• セッション状態の制御