profile の properties の add 要素 (ASP.NET 設定スキーマ)

[アーティクル]
05/27/2012

[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]

ユーザープロファイルにプロパティを追加します。

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

<add 
    name="property name" 
    type="fully qualified type reference"
    provider="provider name"
    serializeAs="String|Xml|Binary|ProviderSpecific"
    allowAnonymous="true|false"
    defaultValue="default property value"
    readOnly="true|false"
    customProviderData="data for a custom profile provider" />
/>

属性および要素

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

属性

属性	Description
name	必須の String 属性です。プロパティの名前を指定します。この値は、自動的に生成されるプロファイルクラスのプロパティ名として、また Properties コレクション内のプロパティのインデックス値として使用されます。プロパティの名前にピリオド (.) を含めることはできません。ユーザープロファイルプロパティの自動生成の詳細については、「Understanding ASP.NET Profile Properties」を参照してください。
type	省略可能な String 属性です。プロパティの型を指定します。既定値は、String です。
provider	省略可能な String 属性です。プロパティの値を格納および取得するために使用されるプロファイルプロバイダーを指定します。 provider 属性の値は、providers 要素に指定されたプロファイルプロバイダーのうちのいずれかの名前です。プロバイダー名を指定しない場合、profile 要素に指定された既定のプロバイダーが使用されます。プロファイルプロバイダーの詳細については、「ASP.NET Profile Providers」を参照してください。
serializeAs	省略可能な SettingsSerializeAs 属性です。データストア内のプロパティ値のシリアル化形式を指定します。既定のシリアル化形式はプロバイダー固有です。使用される実際のシリアル化は、プロバイダーによって決定されます。たとえば、SQL プロバイダーの場合は String シリアル化が使用されます。
allowAnonymous	省略可能な Boolean 型の属性です。アプリケーションのユーザーが匿名の場合に、プロパティを取得または設定できるかどうかを指定します。 true に設定された場合、アプリケーションのユーザーが匿名の場合にプロパティを取得または設定できます。既定値は、false です。
defaultValue	省略可能な String 属性です。データストアに Profile プロパティの値がない場合、次のように既定値を指定します。プロパティの型が XML シリアル化形式でシリアル化されている場合、この属性はプロパティ型のシリアル化されたインスタンスを表す XML 文字列に設定できます。プロパティの型がバイナリシリアル化形式でシリアル化されている場合、この属性はプロパティ型のシリアル化されたインスタンスを表す Base-64 エンコード文字列に設定できます。プロパティが参照型の場合、String null 値を使用して、Profile プロパティが初期化されていないプロファイルに null を返すように示すことができます。
readOnly	省略可能な Boolean 型の属性です。プロパティを読み取ることができても設定できないかどうかを指定します。 true に設定された場合、プロパティは読み取ることができても設定できません。既定値は、false です。
customProviderData	省略可能な String 属性です。 customProviderData 属性を、プロパティのプロファイルプロバイダーが使用する任意の文字列値に設定できるかどうかを指定します。この属性が設定されると、値はプロパティの Attributes コレクションに置かれ、"CustomProviderData" という名前のインデックスが付けられます。

子要素

なし。

親要素

要素	Description
configuration	共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素を指定します。
system.web	ASP.NET 構成セクションのルート要素を指定します。
profile	アプリケーションのユーザープロファイルを構成します。
properties	ユーザープロファイルプロパティおよびプロパティグループのコレクションを定義します。

解説

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

使用例

次の Web.config ファイルの例では、文字列型の ZipCode プロパティおよび StringCollection 型の RecentSearchList プロパティを含むユーザープロファイルを指定する方法を示します。生成された Profile プロパティには、指定した各プロパティの厳密に型指定されたアクセサーが含まれます。ユーザープロファイル、およびユーザープロファイルプロパティの設定と読み込みの例については、「ASP.NET Profile Properties Overview」を参照してください。

<configuration>
   <connectionStrings>
       <add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial 
            Catalog=aspnetdb;" />
   </connectionStrings>

  <system.web>
   <anonymousIdentification enabled="true" />

   <profile defaultProvider="SqlProvider" >
     <providers>
       <add
         name="SqlProvider"
         connectionStringName="SqlServices"
         applicationName="HttpProfileBaseApplication"
         type="System.Web.Profile.SqlProfileProvider" />
     </providers>

     <properties>
       <add name="ZipCode" allowAnonymous="true" />
       <add name="RecentSearchList"
            type="System.Collections.Specialized.StringCollection"
            serializeAs="Xml"
            allowAnonymous="true" />
      </properties>
    </profile>
   </system.web>
</configuration>

要素情報

構成セクションハンドラー	System.Web.Configuration.ProfileSection
構成メンバー	SystemWebSectionGroup.Profile
構成できる場所	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

参照

次の方法で共有

profile の properties の add 要素 (ASP.NET 設定スキーマ)

属性および要素

属性

子要素

親要素

解説

使用例

要素情報

参照

処理手順

Reference

概念

その他の技術情報

その他のリソース