profile 요소의 properties 요소에 대한 add 요소(ASP.NET 설정 스키마)

아티클
09/05/2008

업데이트: 2007년 11월

사용자 프로필에 속성을 추가합니다.

이 요소는 .NET Framework 버전 2.0에서 새로 도입되었습니다.

<configuration> 요소
  system.web 요소(ASP.NET 설정 스키마)
    profile 요소(ASP.NET 설정 스키마)
      profile 요소에 대한 properties 요소(ASP.NET 설정 스키마)
        profile 요소의 properties 요소에 대한 add 요소(ASP.NET 설정 스키마)

<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" />
/>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	설명
name	필수 String 특성입니다. 속성 이름을 지정합니다. 이 값은 자동으로 생성된 프로필 클래스의 속성 이름 및 Properties 컬렉션에 있는 속성의 인덱스 값으로 사용됩니다. 속성 이름에는 마침표(.)를 사용할 수 없습니다. 사용자 프로필 속성을 자동으로 생성하는 방법에 대한 자세한 내용은 ASP.NET 프로필 속성 개요를 참조하십시오.
type	선택적 String 특성입니다. 속성 형식을 지정합니다. 기본값은 String입니다.
provider	선택적 String 특성입니다. 속성 값을 저장하고 검색하는 데 사용되는 프로필 공급자를 지정합니다. provider 특성의 값은 providers 요소에 지정된 프로필 공급자의 이름 중 하나입니다. 공급자 이름이 지정되어 있지 않으면 profile 요소에 지정된 기본 공급자가 사용됩니다. 프로필 공급자에 대한 자세한 내용은 ASP.NET 프로필 공급자를 참조하십시오.
serializeAs	선택적 SettingsSerializeAs 특성입니다. 데이터 저장소에 있는 속성 값에 대한 serialization 형식을 지정합니다. 기본 serialization 형식은 공급자에 따라 다릅니다. 사용되는 실제 serialization은 공급자에 따라 결정되며 SQL 공급자의 경우에는 String serialization이 사용됩니다.
allowAnonymous	선택적 Boolean 특성입니다. 응용 프로그램 사용자가 익명인 경우 속성을 가져오거나 설정할 수 있는지 여부를 지정합니다. 이 특성을 true로 설정하면 응용 프로그램 사용자가 익명인 경우 속성을 가져오거나 설정할 수 있습니다. 기본값은 false입니다.
defaultValue	선택적 String 특성입니다. 데이터 저장소에 Profile 속성에 대한 값이 없는 경우에 사용할 기본값을 다음과 같이 지정합니다. XML serialization을 사용하여 속성 형식을 serialize하는 경우 이 특성을 속성 형식의 serialize된 인스턴스를 나타내는 XML 문자열로 설정할 수 있습니다. 이진 serialization을 사용하여 속성 형식을 serialize하는 경우 이 특성을 속성 형식의 serialize된 인스턴스를 나타내는 base-64 인코딩된 문자열로 설정할 수 있습니다. 속성이 참조 형식인 경우에는 String null 값을 사용하여 Profile 속성에서 초기화되지 않은 프로필에 대해 null을 반환해야 함을 나타낼 수 있습니다.
readOnly	선택적 Boolean 특성입니다. 속성을 읽을 수는 있지만 설정할 수 없는지 여부를 지정합니다. 이 특성을 true로 설정하면 속성을 읽을 수는 있지만 설정할 수 없습니다. 기본값은 false입니다.
customProviderData	선택적 String 특성입니다. customProviderData 특성을 속성에 대한 프로필 공급자에서 사용할 모든 문자열 값으로 설정할 수 있도록 지정합니다. 이 특성을 설정하면 해당 값은 속성의 Attributes 컬렉션에 추가되고 "CustomProviderData"라는 이름으로 인덱싱됩니다.

자식 요소

없음

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 루트 요소를 지정합니다.
system.web	ASP.NET 구성 섹션의 루트 요소를 지정합니다.
profile	응용 프로그램에 대한 사용자 프로필을 구성합니다.
properties	사용자 프로필 속성 및 속성 그룹의 컬렉션을 정의합니다.

설명

응용 프로그램 코드에서 profile 요소의 구성 값에 액세스하여 수정하는 방법에 대한 내용은 ProfileSection을 참조하십시오.

예제

다음 Web.config 파일 예제에서는 문자열 형식의 ZipCode 속성과 StringCollection 형식의 RecentSearchList 속성이 포함된 사용자 프로필을 지정하는 방법을 보여 줍니다. 생성된 Profile 속성은 지정한 각 속성에 대해 강력한 형식의 접근자를 가지게 됩니다. 사용자 프로필에 대한 자세한 내용 및 사용자 프로필 속성을 설정하고 읽는 방법에 대한 예제를 보려면 ASP.NET 프로필 속성 개요를 참조하십시오.

<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 IIS(인터넷 정보 서비스) 버전 5.0, 5.1 또는 6.0 .NET Framework 버전 2.0 Microsoft Visual Studio 2005

참고 항목

다음을 통해 공유