PersonalizationAdministration.FindUserState 메서드

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch);

public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch);

static member FindUserState : string * string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public Shared Function FindUserState (pathToMatch As String, usernameToMatch As String) As PersonalizationStateInfoCollection

매개 변수

반환

사용자별 개인 설정 상태 정보가 들어 있는 PersonalizationStateInfoCollection입니다.

예외

예제

다음 코드 예제에서는 FindUserState 메서드를 사용하는 방법을 보여 줍니다. 전체 예제는 클래스 개요 항목에서 PersonalizationAdministration 찾을 수 있습니다.

protected void Button1_Click(object sender, EventArgs e)
{
    if (TextBox3.Text != null)
    {
        PersonalizationStateInfoCollection findresult;
      findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
      if (findresult.Count != 0)
      {
          Label4.Text = findresult.Count + "  user(s) found";
          Label4.Visible = true;
      }
      else
      {
          Label4.Text = "No users found.";
          Label4.Visible = true;
      }
    }
  else
  {
      Label4.Text = "You must enter a user name to find.";
  }

}

설명

이 메서드는 매개 변수 값이 pathToMatch 페이지의 경로와 일치하고 해당 페이지와 usernameToMatch 연결된 개인 설정 데이터가 있는 사용자 이름과 일치하는 인스턴스의 컬렉션을 UserPersonalizationStateInfo 반환합니다. 컬렉션에는 인스턴스만 UserPersonalizationStateInfo 포함됩니다.

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

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

마찬가지로 부분 사용자 이름에 대한 와일드카드 검색은 속성의 텍스트 문자열에 있는 임의의 지점에 와일드카드 문자가 UsernameToMatch 표시될 수 있습니다. 예를 들어 "John"으로 시작하는 모든 사용자 이름을 찾으려면 속성은 UsernameToMatch "John%"과 같습니다.

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

및 는 usernameToMatch 모두 pathToMatch 일 null수 있습니다. 매개 변수에는 usernameToMatch 쉼표(,)가 있을 수 있습니다. Microsoft SQL Server 실행하는 데이터 저장소와 같은 일부 데이터 저장소는 쉼표를 와일드카드 문자로 허용하기 때문입니다.

추가 정보

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

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);

static member FindUserState : string * string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public Shared Function FindUserState (pathToMatch As String, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

매개 변수

반환

사용자별 개인 설정 상태 정보가 들어 있는 PersonalizationStateInfoCollection입니다.

예외

예제

다음 코드 예제에서는 FindUserState 메서드를 사용하는 방법을 보여 줍니다. 전체 예제는 클래스 개요 항목에서 PersonalizationAdministration 찾을 수 있습니다.

protected void Button1_Click(object sender, EventArgs e)
{
    if (TextBox3.Text != null)
    {
        PersonalizationStateInfoCollection findresult;
      findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
      if (findresult.Count != 0)
      {
          Label4.Text = findresult.Count + "  user(s) found";
          Label4.Visible = true;
      }
      else
      {
          Label4.Text = "No users found.";
          Label4.Visible = true;
      }
    }
  else
  {
      Label4.Text = "You must enter a user name to find.";
  }

}

설명

이 메서드는 매개 변수 값이 pathToMatch 페이지의 경로와 일치하고 해당 페이지와 usernameToMatch 연결된 개인 설정 데이터가 있는 사용자 이름과 일치하는 인스턴스의 컬렉션을 UserPersonalizationStateInfo 반환합니다. 컬렉션에는 인스턴스만 UserPersonalizationStateInfo 포함됩니다.

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

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

마찬가지로 부분 사용자 이름에 대한 와일드카드 검색은 속성의 텍스트 문자열에 있는 임의의 지점에 와일드카드 문자가 UsernameToMatch 표시될 수 있습니다. 예를 들어 "John"으로 시작하는 모든 사용자 이름을 찾으려면 속성은 UsernameToMatch "John%"과 같습니다.

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

및 는 usernameToMatch 모두 pathToMatch 일 null수 있습니다. 매개 변수에는 usernameToMatch 쉼표(,)가 있을 수 있습니다. Microsoft SQL Server 실행하는 데이터 저장소와 같은 일부 데이터 저장소는 쉼표를 와일드카드 문자로 허용하기 때문입니다.

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

추가 정보

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