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

아티클
09/05/2008

업데이트: 2007년 11월

공급자와 이를 구현하는 클래스의 이름을 지정합니다.

configuration 요소(일반 설정 스키마)
  system.web 요소(ASP.NET 설정 스키마)
    webParts 요소(ASP.NET 설정 스키마)
      webParts에 대한 personalization 요소(ASP.NET 설정 스키마)
        webParts 요소의 personalization 요소에 대한 providers 요소(ASP.NET 설정 스키마)
          webParts 요소의 providers 요소에 대한 add 요소(ASP.NET 설정 스키마)

<add name="String" 
     type="String" 
     connectionStringName="String" 
     applicationName="String" 
     commandTimeout="number"/>

특성 및 요소

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

특성

특성	설명
applicationName	선택적 String 특성입니다. 개인 설정 정보를 저장하고 검색할 응용 프로그램의 이름을 지정합니다.
connectionStringName	필수 String 특성입니다. 데이터베이스에 연결하는 데 사용되는 SQL 공급자별 문자열을 지정합니다.
commandTimeout	선택적 Int32 특성입니다. 웹 파트 개인 설정 데이터 소스에 대해 실행한 명령의 제한 시간이 초과되기까지 걸리는 시간(초)을 지정합니다. 이 제한 시간은 SQL 공급자가 SqlCommand 개체를 만들 때 사용됩니다. 이 특성은 ASP.NET 구성에 기본적으로 설정되어 있지 않으므로 ADO.NET 기본값인 30초가 사용됩니다. 이 특성을 설정하면 SQL 공급자는 데이터베이스에 대해 실행하는 모든 SQL 명령에 대해 구성된 제한 시간 값을 사용합니다.
name	필수 String 특성입니다. 공급자 이름입니다.
type	필수 String 특성입니다. PersonalizationProvider 기본 클래스를 구현하는 클래스에 대한 정규화된 어셈블리 참조를 지정합니다. 이 값은 공급자를 포함하는 코드의 위치에 따라 부분 참조(예: Namespace.ClassName만 있거나 Namespace.Classname과 AssemblyName이 있는 경우)가 될 수도 있고, PersonalizationProvider 기본 클래스를 구현하는 클래스에 대한 정규화된 어셈블리 참조가 될 수도 있습니다.

자식 요소

없음

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필요한 루트 요소입니다.
system.web	구성 파일에 있는 ASP.NET 구성 설정의 루트 요소를 지정합니다. ASP.NET 웹 응용 프로그램을 구성하고 응용 프로그램의 동작 방법을 제어하는 구성 요소를 포함합니다.
webParts	웹 파트 개인 설정 공급자를 지정하고 개인 설정 권한을 설정할 수 있으며 웹 파트 연결에서 사용할 WebPartTransformer 클래스를 확장하는 사용자 지정 클래스를 추가할 수 있습니다.
personalization	웹 파트 개인 설정 공급자를 지정하고 웹 파트 개인 설정 권한을 설정합니다.
providers	현재 웹 응용 프로그램의 웹 파트 개인 설정 공급자를 정의합니다.

설명

기본 신뢰 수준인 Medium 이상으로 웹 응용 프로그램을 실행하지 않으면 개인 설정이 실패할 수 있습니다. <trust level="" /> 요소를 사용하면 Web.config 파일에서 사용자 지정 신뢰 수준을 설정할 수 있습니다. PersonalizationAdministration 클래스와 SqlPersonalizationProvider 클래스는 초기화될 때 신뢰 수준이 Low인지 확인합니다. Low 신뢰 수준으로 실행되도록 응용 프로그램을 구성한 상태에서 기본 SqlPersonalizationProvider를 사용하여 응용 프로그램의 개인 설정 데이터를 관리할 경우, 응용 프로그램에서 개인 설정 데이터에 처음으로 액세스하려고 하면 작업이 실패합니다. Low 신뢰 수준으로 실행되는 ASP.NET 작업자 프로세스에 System.Data.SqlClient 네임스페이스의 여러 클래스를 호출하는 데 필요한 권한이 없기 때문입니다.

기본 구성

다음의 기본 add 요소는 .NET Framework 버전 2.0의 루트 Web.config 파일에 구성되어 있습니다.

<providers>
  <add name="AspNetSqlPersonalizationProvider" 
    type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
    connectionStringName="LocalSqlServer"
  />
</providers>

예제

다음 예제에서는 공급자를 추가하는 방법을 보여 줍니다.

<webParts>
  <personalization defaultProvider="AspNetSqlPersonalizationProvider">
    <providers>
      <add name="AspNetSqlPersonalizationProvider"
      type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
        connectionStringName="LocalSqlServer" 
        applicationName="/" />
    </providers>
  </personalization>
</webParts>

공급자는 컴퓨터, 사이트 및 응용 프로그램 수준에서만 정의할 수 있습니다.

요소 정보

구성 섹션 처리기	System.Web.Configuration.WebPartsSection
구성 멤버	WebPartsPersonalization.Providers
구성 가능한 위치	Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config
요구 사항	IIS 5.0, 5.1 및 6.0 .NET Framework 2.0 Visual Studio 2005

참고 항목

다음을 통해 공유