PersonalizationProvider 클래스

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

개인 설정 공급자의 기본 기능을 구현합니다.

public ref class PersonalizationProvider abstract : System::Configuration::Provider::ProviderBase

public abstract class PersonalizationProvider : System.Configuration.Provider.ProviderBase

type PersonalizationProvider = class
    inherit ProviderBase

Public MustInherit Class PersonalizationProvider
Inherits ProviderBase

상속

Object

ProviderBase

PersonalizationProvider

파생

System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider

설명

개인 설정 공급자의 필수 기능을 정의하는 추상 기본 클래스입니다. 개인 설정 공급자는 인스턴스를 대신하여 WebPartPersonalization 개인 설정 데이터를 로드하고 저장합니다.

기본 클래스는 여러 메서드에 대한 표준 동작을 정의합니다. 기본 데이터 저장소를 구체적으로 처리하는 메서드만 추상으로 표시됩니다. 이를 통해 개발자는 클래스에서 사용하는 표준 기능을 다시 구현할 필요 없이 특정 데이터 저장소와 상호 작용할 사용자 지정 공급자를 WebPartPersonalization 작성할 수 있습니다.

구현자 참고

에서 파생 PersonalizationProvider 하고 이 클래스에 정의된 추상 메서드에 대해서만 구현을 제공할 수 있습니다. 추상 메서드는 특히 물리적 데이터 저장소에 데이터를 저장 및 로드하고 데이터 저장소 관리를 사용합니다. 사용자 지정 공급자는 데이터와 User 데이터를 구분 Shared 하는 방식으로 개인 설정 정보를 조작할 수 있어야 합니다. 또한 애플리케이션 뿐만 아니라 페이지에서 공급자를 개인 설정 데이터를 분할 해야 합니다.

PersonalizationProvider 의 구현은 일부 개인 설정 공급자 메서드가 파생 클래스의 인스턴스를 반환하기 때문에 의 PersonalizationState구현 PersonalizationState 과 긴밀하게 결합됩니다. 사용자 지정 공급자 PersonalizationProvider 의 개발을 용이하게 하기 위해 기본 클래스에는 클래스에서 직접 WebPartPersonalization 사용하는 개인 설정 논리 및 serialization/deserialization 논리의 기본 구현이 포함됩니다. 따라서 다른 데이터 저장소를 사용하기 위해서만 사용자 지정 공급자를 작성하려면 다음 추상 메서드를 구현해야 합니다.

• GetCountOfState(PersonalizationScope, PersonalizationStateQuery) - 이 메서드는 제공된 쿼리 매개 변수에 대한 데이터베이스의 개인 설정 데이터 행 수를 계산할 수 있어야 합니다.

• LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) - 경로와 사용자 이름이 지정되면 이 메서드는 데이터베이스에서 두 개의 BLOB(Binary Large Object)을 로드합니다. 하나는 공유 데이터에 대한 BLOB이고 다른 하나는 사용자 데이터용입니다. 사용자 이름 및 경로를 제공하는 경우 사용자 이름/경로 정보를 제공할 수 있는 페이지 정보에 액세스하기 위해 컨트롤이 필요하지 WebPartManager 않습니다.

• ResetPersonalizationBlob(WebPartManager, String, String) - 경로 및 사용자 이름을 지정하면 이 메서드는 데이터베이스에서 해당 행을 삭제합니다. 사용자 이름 및 경로를 제공하는 경우 사용자 이름/경로 정보를 제공할 수 있는 페이지 정보에 액세스하기 위해 컨트롤이 필요하지 WebPartManager 않습니다.

• SavePersonalizationBlob(WebPartManager, String, String, Byte[]) - 경로 및 사용자 이름을 지정하면 이 메서드는 제공된 BLOB을 데이터베이스에 저장합니다. 사용자 이름 및 경로를 제공하는 경우 사용자 이름/경로 정보를 제공할 수 있는 페이지 정보에 액세스하기 위해 컨트롤이 필요하지 WebPartManager 않습니다.

이러한 모든 메서드에서 경로만 제공되면 페이지의 공유 개인 설정 데이터가 작동 중임을 나타냅니다. 경로와 사용자 이름이 모두 메서드에 전달되는 경우 페이지의 사용자 개인 설정 데이터를 적용해야 합니다. 의 LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])경우 지정된 경로에 대한 공유 데이터를 항상 로드해야 하며, 필요에 따라 사용자 이름이 이 아닌 null경우 경로에 대한 사용자 개인 설정 데이터도 로드해야 합니다.

다른 모든 추상 메서드는 관리 애플리케이션 에서만에서 사용 됩니다 및 런타임 시 웹 파트 인프라에서 사용 되지 않습니다. 개인 설정 공급자의 구현 예제는 클래스를 참조하세요 SqlPersonalizationProvider .

생성자

PersonalizationProvider()

PersonalizationProvider 클래스의 새 인스턴스를 초기화합니다.

속성

ApplicationName	파생 클래스에서 재정의된 경우 공급자에 대해 구성된 애플리케이션의 이름을 가져오거나 설정합니다.
Description	관리 도구나 다른 UI(사용자 인터페이스)에 표시하기에 적합한 간단하고 이해하기 쉬운 설명을 가져옵니다. (다음에서 상속됨 ProviderBase)
Name	구성 중 공급자를 참조하는 데 사용되는 이름을 가져옵니다. (다음에서 상속됨 ProviderBase)

메서드

CreateSupportedUserCapabilities()	웹 파트 컨트롤 집합에 사용되는 알려진 기능의 집합을 나타내는 WebPartUserCapability 개체 목록을 반환합니다.
DetermineInitialScope(WebPartManager, PersonalizationState)	초기 개인 설정 범위를 Shared 범위로 할지 User 범위로 할지 결정합니다.
DetermineUserCapabilities(WebPartManager)	현재 실행 중인 사용자 계정의 개인 설정 관련 기능을 나타내는 WebPartUserCapability 인스턴스가 들어 있는 사전을 반환합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32)	파생 클래스에서 재정의된 경우 범위와 특정 쿼리 매개 변수를 기반으로 0개 이상의 PersonalizationStateInfo 파생 개체가 포함된 컬렉션을 반환합니다.
GetCountOfState(PersonalizationScope, PersonalizationStateQuery)	파생 클래스에서 재정의된 경우 내부 데이터 저장소에서 지정된 범위 안에 있는 행의 수를 반환합니다.
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
Initialize(String, NameValueCollection)	구성 작성기를 초기화합니다. (다음에서 상속됨 ProviderBase)
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])	파생 클래스에서 재정의된 경우 내부 데이터 저장소의 원시 개인 설정 데이터를 로드합니다.
LoadPersonalizationState(WebPartManager, Boolean)	내부 데이터 저장소에서 원시 데이터를 로드하고 이 데이터를 PersonalizationState 개체로 변환합니다.
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ResetPersonalizationBlob(WebPartManager, String, String)	파생 클래스에서 재정의된 경우 내부 데이터 저장소의 원시 개인 설정 데이터를 삭제합니다.
ResetPersonalizationState(WebPartManager)	내부 데이터 저장소에 대한 개인 설정 데이터를 다시 설정합니다.
ResetState(PersonalizationScope, String[], String[])	파생 클래스에서 재정의된 경우 지정된 매개 변수를 기반으로 내부 데이터 저장소에서 개인 설정 상태를 삭제합니다.
ResetUserState(String, DateTime)	파생 클래스에서 재정의된 경우 지정된 매개 변수를 기반으로 내부 데이터 저장소에서 웹 파트 개인 설정 데이터를 삭제합니다.
SavePersonalizationBlob(WebPartManager, String, String, Byte[])	파생 클래스에서 재정의된 경우 내부 데이터 저장소에 원시 개인 설정 데이터를 저장합니다.
SavePersonalizationState(PersonalizationState)	개인 설정 데이터를 데이터 저장소에 저장합니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

추가 정보

• SqlPersonalizationProvider
• 웹 파트 컨트롤 ASP.NET
• 웹 파트 개인 설정 개요
• 연습: 사용자 컨트롤을 사용하여 웹 파트 개인 설정 구현
• 웹 파트 개인 설정