SessionStateSection クラス

定義

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
継承

このセクションでは、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 クラスは、sessionState タグによって識別される Machine.config または Web.config 構成ファイル内の要素を参照します。

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

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

コンストラクター

名前 説明
SessionStateSection()

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

プロパティ

名前 説明
AllowCustomSqlDatabase

ユーザーが SqlConnectionString プロパティで初期カタログ値を指定できるかどうかを示す値を取得または設定します。

CompressionEnabled

セッション状態データに対して圧縮が有効かどうかを示す値を取得または設定します。

Cookieless

Cookie を使用してクライアント セッションを識別するかどうかを示す値を取得または設定します。

CookieName

Cookie 名を取得または設定します。

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)

ファイルに書き込む単一のセクションとして、 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)

適用対象

こちらもご覧ください