profile 요소의 providers 요소에 대한 add 요소(ASP.NET 설정 스키마)
업데이트: 2007년 11월
사용자 프로필 공급자 컬렉션에 프로필 공급자 인스턴스를 추가합니다.
이 요소는 .NET Framework 버전 2.0에서 새로 도입되었습니다.
<configuration> 요소
system.web 요소(ASP.NET 설정 스키마)
profile 요소(ASP.NET 설정 스키마)
profile 요소에 대한 providers 요소(ASP.NET 설정 스키마)
profile 요소의 providers 요소에 대한 add 요소(ASP.NET 설정 스키마)
<add
name="provider name"
type="fully qualified type reference"
connectionStringName="connection string identifier"
commandTimeout="number of seconds before a command times out"
description="description of the provider instance"
applicationName="application name for stored profile information" />
특성 및 요소
다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
특성
특성 |
설명 |
|---|---|
name |
필수 String 특성입니다. 공급자 인스턴스의 이름을 지정합니다. 이 값은 공급자 인스턴스를 기본 프로필 공급자로 식별하기 위해 <profile> 요소의 defaultProvider 특성에 사용됩니다. 공급자의 name은 Providers 컬렉션에서 공급자의 인덱스를 만드는 데도 사용됩니다. |
type |
필수 String 특성입니다. ProfileProvider 추상 기본 클래스를 구현하는 형식을 지정합니다. |
connectionStringName |
필수 String 특성입니다. <connectionStrings> 요소에 정의된 연결 문자열의 이름을 지정합니다. 지정한 연결 문자열은 앞으로 추가할 공급자에 사용됩니다. |
applicationName |
선택적 String 특성입니다. 데이터 소스에서 프로필 데이터가 저장되는 응용 프로그램의 이름을 지정합니다. 응용 프로그램 이름을 사용하면 여러 다른 ASP.NET 응용 프로그램에서 중복되는 프로필 데이터를 사용하지 않고 동일한 데이터베이스를 사용할 수 있습니다. 또는 동일한 응용 프로그램 이름을 지정하여 여러 ASP.NET 응용 프로그램에서 동일한 프로필 정보를 사용할 수 있습니다. 이 특성을 지정하지 않으면 .NET Framework에 포함된 프로필 공급자는 ApplicationName 속성에 대해 ApplicationVirtualPath 값을 사용합니다. |
commandTimeout |
선택적 Int32 특성입니다. 멤버 자격 데이터 소스에 대해 실행되는 명령이 시간 초과되기 전의 시간(초)을 지정합니다. 이 제한 시간은 SQL 공급자가 SqlCommand 개체를 만들 때 사용됩니다. 기본적으로 이 특성은 ASP.NET 구성에 설정되어 있지 않습니다. 따라서 ADO.NET 기본값인 30초가 사용됩니다. 이 특성을 설정하면 SQL 공급자는 데이터베이스에 대해 실행되는 모든 SQL 명령에 해당 제한 시간 값을 사용합니다. 기본값은 30(ADO.NET 기본값)입니다. |
description |
선택적 String 특성입니다. 프로필 공급자 인스턴스에 대한 설명을 지정합니다. |
자식 요소
없음
부모 요소
요소 |
설명 |
|---|---|
providers |
사용자 프로필에 대한 프로필 공급자 컬렉션을 정의합니다. |
profile |
응용 프로그램에 대한 사용자 프로필을 구성합니다. |
configuration |
공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 루트 요소를 지정합니다. |
system.web |
ASP.NET 구성 섹션의 루트 요소를 지정합니다. |
설명
사용자 지정 프로필 공급자 구현을 위해 add 요소에 추가 특성을 포함할 수 있습니다. 예제를 보려면 방법: 프로필 공급자 예제 빌드 및 실행을 참조하십시오.
응용 프로그램 코드에서 profile 요소의 구성 값에 액세스하여 수정하는 방법에 대한 내용은 ProfileSection을 참조하십시오.
기본 구성
다음의 기본 profile 요소는 .NET Framework 버전 2.0의 Machine.config 파일에 구성되어 있습니다.
<providers>
<add name="AspNetSqlProfileProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Profile.SqlProfileProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</providers>
예제
다음 코드 예제에서는 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 IIS(인터넷 정보 서비스) 버전 5.0, 5.1 또는 6.0 .NET Framework 버전 2.0 Microsoft Visual Studio 2005 |
참고 항목
작업
개념
참조
profile 요소의 providers 요소에 대한 remove 요소(ASP.NET 설정 스키마)
profile 요소의 providers 요소에 대한 clear 요소(ASP.NET 설정 스키마)