profile 要素 (ASP.NET 設定スキーマ)
更新 : 2007 年 11 月
ASP.NET プロファイルを使用してユーザー プロファイル値を管理するためのパラメータを構成します。
この要素は、.NET Framework Version 2.0 で追加されました。
<configuration> 要素
system.web 要素 (ASP.NET 設定スキーマ)
profile 要素 (ASP.NET 設定スキーマ)
<profile
enabled="true|false"
inherits="fully qualified type reference"
automaticSaveEnabled="true|false"
defaultProvider="provider name">
<properties>...</properties>
<providers>...</providers>
</profile>
属性と要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
説明 |
|---|---|
enabled |
省略可能な Boolean 型の属性です。 ASP.NET ユーザー プロファイルを有効にするかどうかを指定します。true の場合、ASP.NET ユーザー プロファイルは有効になります。 既定値は true です。 |
defaultProvider |
省略可能な String 属性です。 既定のプロファイル プロバイダの名前を指定します。 詳細については、「Provider」を参照してください。 既定値は AspNetSqlProfileProvider です。 |
inherits |
省略可能な String 属性です。 ProfileBase 抽象クラスから派生したカスタム型への型参照を格納します。ASP.NET は、この型から継承する ProfileCommon クラスを動的に生成し、現在の HttpContext の Profile プロパティに配置します。 |
automaticSaveEnabled |
省略可能な Boolean 型の属性です。 ASP.NET ページの実行終了時にユーザー プロファイルを自動的に保存するかどうかを指定します。true の場合、ASP.NET ページの実行終了時にユーザー プロファイルを自動的に保存します。 ProfileModule オブジェクトは、プロファイルが変更されたことがモジュールにより検出された場合だけユーザー プロファイルを保存します。つまり、IsDirty プロパティは true です。詳細については、「ASP.NET プロファイル プロパティの概要」を参照してください。 既定値は true です。 |
子要素
要素 |
説明 |
|---|---|
properties |
必須の要素 ユーザー プロファイル プロパティおよびプロパティ グループのコレクションを定義します。 |
providers |
省略可能な要素 プロファイル プロバイダのコレクションを定義します。 |
親要素
要素 |
説明 |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework ベースのアプリケーションで使用されるすべての構成ファイルで必要なルート要素です。 |
system.web |
ASP.NET 構成セクションのルート要素を指定します。 |
解説
アプリケーション コード内の profile 要素の構成値のアクセスおよび変更方法については、ProfileSection を参照してください。
既定の構成
次の既定の profile 要素は、.NET Framework Version 2.0 の Machine.config ファイルで構成されます。
<profile>
<providers>
<add name="AspNetSqlProfileProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Profile.SqlProfileProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</providers>
</profile>
使用例
SqlProfileProvider プロバイダを使用する ASP.NET アプリケーションの Web.config ファイルの構成方法を次のコード例に示します。
<configuration>
<connectionStrings>
<add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial
Catalog=aspnetdb;" />
</connectionStrings>
<system.web>
<authentication mode="Forms" >
<forms loginUrl="login.aspx" name=".ASPXFORMSAUTH" />
</authentication>
<authorization>
<deny users="?" />
</authorization>
<membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="15">
<providers>
<clear/>
<add name="SqlProvider"
type="System.Web.Security.SqlMembershipProvider"
connectionStringName="SqlServices"
applicationName="SampleApplication"
enablePasswordRetrieval="true"
enablePasswordReset="true"
passwordFormat="Encrypted"
requiresQuestionAndAnswer="true" />
</providers>
</membership>
<profile defaultProvider="SqlProvider">
<providers>
<clear />
<add name="SqlProvider"
type="System.Web.Profile.SqlProfileProvider"
connectionStringName="SqlServices"
applicationName="SampleApplication"
description="SqlProfileProvider for SampleApplication" />
</providers>
<properties>
<add name="ZipCode" />
<add name="CityAndState" />
</properties>
</profile>
</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 2005 |
参照
処理手順
概念
ASP.NET Web サーバー コントロールとブラウザの機能
参照
system.web 要素 (ASP.NET 設定スキーマ)
profile の properties 要素 (ASP.NET 設定スキーマ)
profile の providers 要素 (ASP.NET 設定スキーマ)