sessionState の providers の remove 要素 (ASP.NET 設定スキーマ)
継承したセッション状態ストア プロバイダーへの参照をコレクションから削除します。
この要素は、.NET Framework Version 2.0 で追加されました。
<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>
要素情報
構成セクション ハンドラー |
|
構成メンバー |
|
構成できる場所 |
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 |
参照
処理手順
方法 : Location の設定を使用して特定のディレクトリを構成する
参照
sessionState の providers 要素 (ASP.NET 設定スキーマ)
sessionState の providers の add 要素 (ASP.NET 設定スキーマ)
sessionState の providers の clear 要素 (ASP.NET 設定スキーマ)
sessionState の providers 要素 (ASP.NET 設定スキーマ)
sessionState 要素 (ASP.NET 設定スキーマ)
system.web 要素 (ASP.NET 設定スキーマ)