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

發行項
05/28/2012

移除集合中繼承工作階段狀態存放區提供者的參考。

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

<remove 
   name="provider name"
/>

屬性和項目

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

屬性

屬性	描述
name	必要的 String 屬性。指定要從集合移除之工作階段狀態存放區提供者執行個體的名稱。

子項目

無。

父項目

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

備註

remove 項目會從 providers 項目的集合，移除繼承工作階段狀態存放區提供者的參考。

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

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

範例

下列程式碼範例中，會顯示如何將 ASP.NET 應用程式的 Web.config 檔案設定為使用自訂工作階段狀態存放區提供者。該範例會使用 remove 項目，在加入自訂工作階段狀態存放區執行個體之前，移除名為 OdbcSessionProvider 的現有工作階段狀態存放區提供者物件。

如需實作工作階段狀態存放區提供者 (包括範例提供者) 的詳細資訊，請參閱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>
        <remove name="OdbcSessionProvider" />
        <add name="OdbcSessionProvider"
          type="Samples.AspNet.Session.OdbcSessionStateStore"
          connectionStringName="OdbcSessionServices" 
          writeExceptionsToEventLog="false" />
      </providers>
    </sessionState>
  </system.web>
</configuration>

項目資訊

組態區段處理常式	SessionStateSection
組態成員	Remove 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 提供者的 remove 項目 (ASP.NET 設定結構描述)

屬性和項目

屬性

子項目

父項目

備註

範例

項目資訊

請參閱

工作

參考

概念

其他資源

其他資源