sessionState の providers の remove 要素 (ASP.NET 設定スキーマ)

2008-09-17

更新 : 2007 年 11 月

継承したセッション状態ストアプロバイダへの参照をコレクションから削除します。

この要素は、.NET Framework Version 2.0 で追加されました。

configuration 要素 (全般設定スキーマ)
  system.web 要素 (ASP.NET 設定スキーマ)
    sessionState 要素 (ASP.NET 設定スキーマ)
      sessionState の providers 要素 (ASP.NET 設定スキーマ)
        sessionState の providers の remove 要素 (ASP.NET 設定スキーマ)

<remove 
   name="provider name"
/>

属性と要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性	説明
name	必須の String 属性です。コレクションから削除するセッション状態ストアプロバイダのインスタンスの名前を指定します。

子要素

なし。

親要素

要素	説明
configuration	共通言語ランタイムおよび .NET Framework ベースのアプリケーションで使用されるすべての構成ファイルで必要なルート要素です。
system.web	構成ファイルの ASP.NET 構成設定のルート要素を指定します。ASP.NET Web アプリケーションを構成する構成要素やアプリケーションの動作を制御する構成要素が含まれます。
sessionState	現在のアプリケーションのセッション状態設定値を構成します。
providers	カスタムセッション状態ストアプロバイダのコレクションを格納します。

解説

remove 要素は、providers 要素に格納されているコレクションから、継承したセッション状態ストアプロバイダへの参照を削除します。

providers 要素は、カスタムセッション状態ストアプロバイダのコレクションを格納します。カスタムセッション状態ストアプロバイダは、SessionStateStoreProviderBase クラスから継承する必要があります。

アプリケーションコード内の sessionState 要素の構成値のアクセスおよび変更方法については、ProviderSettingsCollection および Providers の説明を参照してください。

使用例

ASP.NET アプリケーションの Web.config ファイルを構成して、カスタムセッション状態ストアプロバイダを使用する方法を、次のコード例に示します。この例では、カスタムセッション状態ストアプロバイダを追加する前に、remove 要素を使用して、OdbcSessionProvider という名前の既存のセッション状態ストアプロバイダのオブジェクトを削除します。

サンプルプロバイダを含む、セッション状態ストアプロバイダの実装については、「セッション状態ストアプロバイダの実装」を参照してください。

<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 Version 2.0 Microsoft Visual Studio 2003 または Visual Studio 2005

参照

次の方法で共有

sessionState の providers の remove 要素 (ASP.NET 設定スキーマ)

属性と要素

属性

子要素

親要素

解説

使用例

要素情報

参照

処理手順

概念

参照

その他の技術情報

その他のリソース