sessionState 提供者的 clear 項目 (ASP.NET 設定結構描述)

發行項
05/28/2012

移除已繼承之工作階段狀態存放區提供者的所有參考，只允許由目前 add 項目所加入的工作階段狀態存放區提供者。

這個項目是 .NET Framework 2.0 版中新增的項目。

<clear/>

屬性和項目

下列章節會說明屬性、子項目和父項目。

屬性

無。

子項目

無。

父項目

項目	描述
configuration	指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。
system.web	指定組態檔中 ASP.NET 組態設定的根項目 (Root Element)，並包含會設定 ASP.NET Web 應用程式以及控制這些應用程式之行為的組態項目。
sessionState	設定目前應用程式的工作階段狀態設定。
providers	包含自訂工作階段狀態存放區提供者的集合。

備註

clear 項目會移除 providers 集合中已繼承之工作階段狀態存放區提供者的所有參考，只允許由後續 add 項目所加入的工作階段狀態存放區提供者。

providers 項目包含自訂工作階段狀態存放區提供者的集合。自訂工作階段狀態存放區提供者必須繼承自 SessionStateStoreProviderBase 類別。

如需存取和修改應用程式程式碼中 sessionState 項目組態值的詳細資訊，請參閱 ProviderSettingsCollection 和 Providers。

預設組態

下列預設 providers 項目不會明確地設定在 Machine.config 檔案或根 Web.config 檔案中。然而，應用程式傳回的是預設組態。

<sessionState
   <!-- Attribute settings. -->
>
   <providers>
      <clear />
   </providers>
</sessionState>

範例

下列程式碼範例中，會顯示如何將 ASP.NET 應用程式的 Web.config 檔案設定為使用自訂工作階段狀態存放區提供者。該範例使用 clear 項目，在加入狀態存放區提供者的自訂執行個體之前，清除全部的現有工作階段狀態存放區提供者執行個體。如需實作工作階段狀態存放區提供者以及範例提供者的詳細資訊，請參閱Implementing a Session State Store Provider。

<configuration>
  <connectionStrings>
    <add name="OdbcSessionServices" connectionString="DSN=SessionState;" />
  </connectionStrings>

  <system.web>
    <sessionState 
      cookieless="true"
      regenerateExpiredSessionId="true" 
      mode="Custom"
      customProvider="OdbcSessionProvider">
      <providers>
        <clear />
        <add name="OdbcSessionProvider"
          type="Samples.AspNet.Session.OdbcSessionStateStore"
          connectionStringName="OdbcSessionServices" 
          writeExceptionsToEventLog="false" />
      </providers>
    </sessionState>
  </system.web>
</configuration>

項目資訊

組態區段處理常式	SessionStateSection
組態成員	Clear Providers
可設定的位置	Machine.config 根層次的 Web.config 應用程式層級的 Web.config
需求	Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 版 .NET Framework 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005

請參閱

共用方式為

sessionState 提供者的 clear 項目 (ASP.NET 設定結構描述)

屬性和項目

屬性

子項目

父項目

備註

預設組態

範例

項目資訊

請參閱

工作

參考

概念

其他資源

其他資源