PersonalizationAdministration.FindUserState Metoda

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Zwraca kolekcję informacji o stanie personalizacji na użytkownika na podstawie określonych parametrów.

Przeciążenia

FindUserState(String, String)	Zwraca kolekcję informacji o stanie personalizacji poszczególnych użytkowników na podstawie nazwy użytkownika i ścieżki strony.
FindUserState(String, String, Int32, Int32, Int32)	Zwraca kolekcję informacji o stanie personalizacji na użytkownika na podstawie określonych parametrów.

FindUserState(String, String)

Zwraca kolekcję informacji o stanie personalizacji poszczególnych użytkowników na podstawie nazwy użytkownika i ścieżki strony.

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

Parametry

pathToMatch

String

Ścieżka strony do dopasowania.

usernameToMatch

String

Nazwa użytkownika zgodna z danymi personalizacji skojarzonymi ze stroną.

Zwraca

PersonalizationStateInfoCollection

Element PersonalizationStateInfoCollection zawierający informacje o stanie personalizacji poszczególnych użytkowników.

Wyjątki

ArgumentException

pathToMatch lub usernameToMatch przed lub po przycinaniu jest pusty ciąg ("").

-lub-

Dostawca dostawcy personalizacji zdefiniowany w konfiguracji nie jest prawidłowym typem.

-lub-

Długość ciągu dowolnego parametru jest większa niż 256 znaków.

ConfigurationErrorsException

Wystąpił wyjątek konfiguracji podczas próby utworzenia i zainicjowania wystąpienia jednego ze skonfigurowanych dostawców personalizacji.

-lub-

Nie można odnaleźć domyślnego dostawcy personalizacji zdefiniowanego w konfiguracji.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać FindUserState metody . Kompletny przykład można znaleźć w temacie PersonalizationAdministration przeglądu klasy.

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).

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.";
  }

}

Uwagi

Ta metoda zwraca kolekcję UserPersonalizationStateInfo wystąpień, w których pathToMatch wartość parametru odpowiada ścieżce strony i usernameToMatch pasuje do nazwy użytkownika, która ma dane personalizacji skojarzone z tą stroną. Kolekcja zawiera tylko UserPersonalizationStateInfo wystąpienia.

Ta metoda przekazuje symbole wieloznaczne parametru do bazowego dostawcy personalizacji, więc sposób obsługi tych znaków przez magazyn danych zależy od sposobu obsługi znaków przez dostawcę, takich jak gwiazdka (*), symbol procentu (%), lub podkreślenie (_).

Zwykle w przypadku magazynów danych zgodnych z językiem SQL można wykonać wyszukiwanie symboli wieloznacznych na częściowej ścieżce z symbolem wieloznacznymi wyświetlanym na początku, na końcu lub w środku tekstu ciągu wyszukiwania we PathToMatch właściwości . Aby na przykład znaleźć wszystkie ścieżki rozpoczynające się od "~/vdir", PathToMatch właściwość zostanie ustawiona na "~/vdir%".

Podobnie wyszukiwanie symboli wieloznacznych w częściowej nazwie użytkownika może mieć symbol wieloznaczny wyświetlany w dowolnym momencie w ciągu tekstowym UsernameToMatch właściwości. Aby na przykład znaleźć wszystkie nazwy użytkowników rozpoczynające się od "John", UsernameToMatch właściwość będzie wyglądać następująco: "John%".

Przy użyciu domyślnego dostawcy PersonalizationStateInfopersonalizacji obiekty pochodne są zwracane w kolejności alfabetycznej i sortowane według kombinacji ścieżki i nazwy użytkownika w kolejności rosnącej. Kolejność obiektów w kolekcji jest określana przez dostawcę.

Oba pathToMatch elementy i usernameToMatch mogą mieć wartość null. Parametr usernameToMatch może zawierać przecinki (,), ponieważ niektóre magazyny danych, takie jak te z uruchomionym programem Microsoft SQL Server, zezwalają na przecinki jako symbole wieloznaczne.

Zobacz też

• WebPartPersonalization
• kontrolki składników Web Part ASP.NET
• Omówienie personalizacji składników Web Part
• Przewodnik: implementowanie personalizacji składników Web Part za pomocą kontrolki użytkownika
• Personalizacja składników Web Part

FindUserState(String, String, Int32, Int32, Int32)

Zwraca kolekcję informacji o stanie personalizacji na użytkownika na podstawie określonych parametrów.

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

Parametry

pathToMatch

String

Ścieżka strony do dopasowania.

usernameToMatch

String

Nazwa użytkownika zgodna z danymi personalizacji skojarzonymi ze stroną.

pageIndex

Int32

Indeks zerowy strony wyników do zwrócenia.

pageSize

Int32

Liczba rekordów do zwrócenia.

totalRecords

Int32

Całkowita liczba lub dostępne rekordy.

Zwraca

PersonalizationStateInfoCollection

Element PersonalizationStateInfoCollection zawierający informacje o stanie personalizacji poszczególnych użytkowników.

Wyjątki

ArgumentException

pathToMatch lub usernameToMatch przed lub po przycinaniu jest pusty ciąg ("").

-lub-

Parametr pageIndex ma wartość niższą niż zero.

-lub-

pageSize jest mniejsze niż lub równe zero.

-lub-

Kombinacja i pageIndexpageSize przekracza wartość Int32.MaxValue.

-lub-

Dostawca dostawcy personalizacji zdefiniowany w konfiguracji nie jest prawidłowym typem.

-lub-

Długość ciągu dowolnego parametru jest większa niż 256 znaków.

ConfigurationErrorsException

Wystąpił wyjątek konfiguracji podczas próby utworzenia i zainicjowania wystąpienia jednego ze skonfigurowanych dostawców personalizacji.

-lub-

Nie można odnaleźć domyślnego dostawcy personalizacji zdefiniowanego w konfiguracji.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać FindUserState metody . Kompletny przykład można znaleźć w temacie PersonalizationAdministration przeglądu klasy.

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).

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.";
  }

}

Uwagi

Ta metoda zwraca kolekcję UserPersonalizationStateInfo wystąpień, w których pathToMatch wartość parametru odpowiada ścieżce strony i usernameToMatch pasuje do nazwy użytkownika, która ma dane personalizacji skojarzone z tą stroną. Kolekcja zawiera tylko UserPersonalizationStateInfo wystąpienia.

Ta metoda przekazuje symbole wieloznaczne parametru do bazowego dostawcy personalizacji, więc sposób obsługi tych znaków przez magazyn danych zależy od tego, jak dostawca obsługuje znaki jako gwiazdkę (*), symbol procentu (%), lub podkreślenie (_).

Zwykle w przypadku magazynów danych zgodnych z językiem SQL można wykonać wyszukiwanie symboli wieloznacznych na częściowej ścieżce z symbolem wieloznacznymi wyświetlanym na początku, na końcu lub w środku tekstu ciągu wyszukiwania we PathToMatch właściwości . Aby na przykład znaleźć wszystkie ścieżki rozpoczynające się od "~/vdir", PathToMatch właściwość zostanie ustawiona na "~/vdir%".

Podobnie wyszukiwanie symboli wieloznacznych w częściowej nazwie użytkownika może mieć symbol wieloznaczny wyświetlany w dowolnym momencie w ciągu tekstowym UsernameToMatch właściwości. Aby na przykład znaleźć wszystkie nazwy użytkowników rozpoczynające się od "John", UsernameToMatch właściwość będzie wyglądać następująco: "John%".

Przy użyciu domyślnego dostawcy PersonalizationStateInfopersonalizacji obiekty pochodne są zwracane w kolejności alfabetycznej i sortowane według kombinacji ścieżki i nazwy użytkownika w kolejności rosnącej. Kolejność obiektów w kolekcji jest określana przez dostawcę.

Oba pathToMatch elementy i usernameToMatch mogą mieć wartość null. Parametr usernameToMatch może zawierać przecinki (,), ponieważ niektóre magazyny danych, takie jak te z uruchomionym programem Microsoft SQL Server, zezwalają na przecinki jako symbole wieloznaczne.

Zwracane dane są ograniczone przez pageIndex elementy i pageSize, gdzie pageIndex kontrolki, które rekordy mają zwracać, i pageSize kontroluje liczbę rekordów do zwrócenia. Jeśli na przykład pageIndex ustawiono wartość 0 i pageSize została ustawiona na 25, zwrócone dane będą pierwszymi 25 wpisami. Jeśli pageIndex ustawiono wartość 1 i pageSize została ustawiona na 25, zwrócone dane będą zawierać wpisy od 26 do 50. Parametr totalRecords zwraca łączną liczbę dostępnych rekordów.

Zobacz też

• WebPartPersonalization
• kontrolki składników Web Part ASP.NET
• Omówienie personalizacji składników Web Part
• Przewodnik: implementowanie personalizacji składników Web Part za pomocą kontrolki użytkownika
• Personalizacja składników Web Part