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

範例

本節提供兩個程式代碼範例。 第一個示範如何針對 區段的 sessionState 數個屬性以宣告方式指定值，這也可以當做 類別的成員 SessionStateSection 存取。 第二個示範如何使用 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 應用程式互動時，就會發出會話標識碼，並在會話有效期間與相同用戶端的所有後續要求相關聯。 此標識碼是用來維護跨要求與用戶端會話相關聯的伺服器端狀態。 控制 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	取得 ConfigurationElement 物件的 ContextInformation 物件。 (繼承來源 ConfigurationElement)
HasContext	取得值，指出 CurrentConfiguration 屬性是否為 null。 (繼承來源 ConfigurationElement)
Item[ConfigurationProperty]	取得或設定此組態項目的屬性 (Property) 或屬性 (Attribute)。 (繼承來源 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	取得或設定值，指定工作階段狀態是否將在用戶端模擬可供使用時加以使用，或者一律還原到裝載識別。

方法

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)	取得值，指出在還原序列化程序中是否遇到未知的屬性 (Attribute)。 (繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	取得值，指出在還原序列化程序中是否遇到未知的項目。 (繼承來源 ConfigurationElement)
OnRequiredPropertyNotFound(String)	在找不到必要的屬性時擲回例外狀況 (Exception)。 (繼承來源 ConfigurationElement)
PostDeserialize()	還原序列化之後呼叫。 (繼承來源 ConfigurationElement)
PreSerialize(XmlWriter)	序列化之前呼叫。 (繼承來源 ConfigurationElement)
Reset(ConfigurationElement)	重設 ConfigurationElement 物件的內部狀態，包括鎖定和屬性的集合。 (繼承來源 ConfigurationElement)
ResetModified()	在衍生類別中實作時，將 IsModified() 方法的值重設為 false。 (繼承來源 ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	在衍生類別中實作時，將此組態項目的內容寫入組態檔中。 (繼承來源 ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	建立 XML 字串，在該字串的單一區段中，包含了要寫入檔案之 ConfigurationSection 物件的取消合併檢視。 (繼承來源 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 工作階段狀態概觀
• 控制工作階段狀態