사용자 프로필 그룹에 속성을 추가합니다.
<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 특성입니다. 속성 값을 저장하고 검색하는 데 사용되는 프로필 공급자를 지정합니다. 이 특성의 값은 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 |
사용자 프로필 속성 및 속성 그룹의 컬렉션을 정의합니다. |
group |
사용자 프로필 속성의 그룹화를 정의합니다. |
설명
응용 프로그램 코드에서 profile 요소의 구성 값에 액세스하여 수정하는 방법에 대한 내용은 ProfileSection을 참조하십시오.
예제
다음 예제 Web.config 파일에서는 그룹 이름이 Address인 속성 그룹이 포함된 사용자 프로필을 지정하는 방법을 보여 줍니다. Profile 속성에 대해 생성되는 그룹화된 속성은 그룹 이름 뒤에 옵니다(예: Profile.Address.Street). 사용자 프로필에 대한 자세한 내용 및 사용자 프로필 속성 그룹을 설정하고 읽는 방법에 대한 예제를 보려면 ASP.NET 프로필 속성 개요를 참조하십시오.
<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"
enablePasswordRetrieval="false"
enablePasswordReset="true"
requiresQuestionAndAnswer="true"
requiresUniqueEmail="false"
passwordFormat="Hashed"
applicationName="MyApplication" />
</providers>
</membership>
<profile defaultProvider="SqlProvider">
<providers>
<add
name="SqlProvider"
connectionStringName="SqlServices"
applicationName="MyApplication"
type="System.Web.Profile.SqlProfileProvider" />
</providers>
<properties>
<add name="ZipCode" />
<group name="Address">
<add name="Street" />
<add name="City" />
<add name="State" />
<add name="CountryOrRegion" />
</group>
</properties>
</profile>
</system.web>
</configuration>
요소 정보
구성 섹션 처리기 |
|
구성 멤버 |
|
구성 가능한 위치 |
Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config |
요구 사항 |
Microsoft IIS(인터넷 정보 서비스) 버전 5.0, 5.1 또는 6.0 .NET Framework 버전 2.0 Microsoft Visual Studio 2005 |
참고 항목
작업
참조
profile 요소의 properties 요소에 대한 group 요소(ASP.NET 설정 스키마)
profile 요소의 group 요소에 대한 remove 요소(ASP.NET 설정 스키마)