Share via

PersonalizationAdministration.FindSharedState 메서드

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls.WebParts
어셈블리:
System.Web.dll

지정된 매개 변수를 기반으로 공유되는 개인 설정 상태 정보의 컬렉션을 반환합니다.

오버로드

FindSharedState(String)

지정된 경로를 기반으로 공유되는 개인 설정 상태 정보의 컬렉션을 반환합니다.
FindSharedState(String, Int32, Int32, Int32)

지정된 매개 변수를 기반으로 공유되는 개인 설정 상태 정보의 컬렉션을 반환합니다.

FindSharedState(String)

지정된 경로를 기반으로 공유되는 개인 설정 상태 정보의 컬렉션을 반환합니다.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState (string pathToMatch);
static member FindSharedState : string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch As String) As PersonalizationStateInfoCollection

매개 변수

pathToMatch
String

일치시킬 페이지 경로입니다.

반환

PersonalizationStateInfoCollection

공유되는 개인 설정 상태 정보가 들어 있는 PersonalizationStateInfoCollection입니다.

예외

ArgumentException

트리밍 전이나 후에 pathToMatch가 빈 문자열("")인 경우

또는

구성에 정의된 개인 설정 공급자에 대한 공급자 형식이 올바르지 않은 경우

또는

매개 변수의 문자열 길이가 256자보다 긴 경우

ConfigurationErrorsException

구성된 개인 설정 공급자 중 하나의 인스턴스를 만들고 초기화하려는 동안 구성 예외가 발생한 경우

또는

구성에 정의된 기본 개인 설정 공급자를 찾을 수 없는 경우

설명

이 메서드는 값이 공유 개인 설정 상태 데이터가 있는 pathToMatch 페이지의 경로와 일치하는 인스턴스의 컬렉션을 UserPersonalizationStateInfo 반환합니다. 컬렉션에는 인스턴스만 SharedPersonalizationStateInfo 포함됩니다.

이 메서드는 기본 개인 설정 공급자에 매개 변수 와일드카드 문자를 전달하므로 데이터 저장소에서 이러한 문자를 처리하는 방법은 공급자가 별표(*), 백분율 기호(%) 또는 밑줄(_)과 같은 문자를 처리하는 방법에 따라 달라집니다.

일반적으로 SQL 규격 데이터 저장소의 경우 속성에서 검색 문자열 텍스트의 시작, 끝 또는 중간에 와일드카드 문자가 표시되는 부분 경로에서 와일드카드 검색을 PathToMatch 수행할 수 있습니다. 예를 들어 "~/vdir"로 시작하는 모든 경로를 찾으려면 속성이 PathToMatch "~/vdir%"로 설정됩니다.

기본 개인 설정 공급자 PersonalizationStateInfo를 사용하여 파생 개체는 사전순으로 반환되고 경로와 사용자 이름을 오름차순으로 조합하여 정렬됩니다. 컬렉션에 있는 개체의 순서는 공급자에 의해 결정됩니다.

합니다 pathToMatch 매개 변수 수 null입니다. 로 null설정하면 쿼리를 수행할 때 매개 변수가 무시됩니다.

추가 정보

적용 대상

FindSharedState(String, Int32, Int32, Int32)

지정된 매개 변수를 기반으로 공유되는 개인 설정 상태 정보의 컬렉션을 반환합니다.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState (string pathToMatch, int pageIndex, int pageSize, out int totalRecords);
static member FindSharedState : string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

매개 변수

pathToMatch
String

일치시킬 페이지 경로입니다.

pageIndex
Int32

반환할 결과 페이지의 인덱스(0부터 시작)입니다.

pageSize
Int32

반환할 레코드 수입니다.

totalRecords
Int32

사용할 수 있는 레코드의 총수입니다.

반환

PersonalizationStateInfoCollection

공유되는 개인 설정 상태 정보가 들어 있는 PersonalizationStateInfoCollection입니다.

예외

ArgumentException

트리밍 전이나 후의 pathToMatch가 빈 문자열("")인 경우

또는

pageIndex가 0보다 작은 경우

또는

pageSize가 0보다 작거나 같습니다.

또는

및 pageSize 의 pageIndex 조합이 Int32.MaxValue를 초과합니다.

또는

구성에 정의된 개인 설정 공급자에 대한 공급자 형식이 올바르지 않은 경우

또는

매개 변수의 문자열 길이가 256자보다 긴 경우

ConfigurationErrorsException

구성된 개인 설정 공급자 중 하나의 인스턴스를 만들고 초기화하려는 동안 구성 예외가 발생한 경우

또는

구성에 정의된 기본 개인 설정 공급자를 찾을 수 없는 경우

설명

이 메서드는 값이 공유 개인 설정 상태 데이터가 있는 pathToMatch 페이지의 경로와 일치하는 인스턴스의 컬렉션을 UserPersonalizationStateInfo 반환합니다. 컬렉션에는 인스턴스만 SharedPersonalizationStateInfo 포함됩니다.

이 메서드는 기본 개인 설정 공급자에 매개 변수 와일드카드 문자를 전달하므로 데이터 저장소에서 이러한 문자를 처리하는 방법은 공급자가 별표(*), 백분율 기호(%) 또는 밑줄(_)과 같은 문자를 처리하는 방법에 따라 달라집니다.

일반적으로 SQL 규격 데이터 저장소의 경우 속성에서 검색 문자열 텍스트의 시작, 끝 또는 중간에 와일드카드 문자가 표시되는 부분 경로에서 와일드카드 검색을 PathToMatch 수행할 수 있습니다. 예를 들어 "~/vdir"로 시작하는 모든 경로를 찾으려면 속성이 PathToMatch "~/vdir%"로 설정됩니다.

기본 개인 설정 공급자 PersonalizationStateInfo를 사용하여 파생 개체는 사전순으로 반환되고 경로와 사용자 이름을 오름차순으로 조합하여 정렬됩니다. 컬렉션에 있는 개체의 순서는 공급자에 의해 결정됩니다.

합니다 pathToMatch 매개 변수 수 null입니다. 로 null설정하면 쿼리를 수행할 때 매개 변수가 무시됩니다.

반환되는 데이터는 및 에 의해 pageIndex 제한됩니다. 여기서 pageIndex 반환할 레코드를 제어하고 pageSize 반환할 레코드 수를 제어pageSize합니다. 예를 들어 가 0으로 설정되고 pageSize 가 25로 설정된 경우 pageIndex 반환되는 데이터는 처음 25개 항목이 됩니다. 가 1로 설정되고 pageSize 25로 설정된 경우 pageIndex 반환되는 데이터는 26~50개 항목이 됩니다. 매개 변수는 totalRecords 사용할 수 있는 총 레코드 수를 반환합니다.

추가 정보

적용 대상