PersonalizationAdministration.FindSharedState 메서드

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

매개 변수

반품

공유 개인 설정 상태 정보를 포함하는 A PersonalizationStateInfoCollection 입니다.

예외

설명

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

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

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

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

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

추가 정보

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

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

매개 변수

반품

공유 개인 설정 상태 정보를 포함하는 A PersonalizationStateInfoCollection 입니다.

예외

설명

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

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

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

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

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

반환되는 pageIndex 데이터는 반환할 레코드를 제어하고 pageSizepageIndex 반환 pageSize 할 레코드 수를 제어하는 제약을 받습니다. 예를 들어 0으로 설정되고 pageIndex 25로 설정된 경우 pageSize 반환되는 데이터는 처음 25개 항목이 됩니다. 1로 설정되고 pageIndex 25로 설정된 경우 pageSize 반환되는 데이터는 26~50개 항목이 됩니다. 매개 변수는 totalRecords 사용할 수 있는 총 레코드 수를 반환합니다.

추가 정보

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