PersonalizationAdministration.FindUserState Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.PersonalizationStateInfoCollectionPublic Shared Function FindUserState (pathToMatch As String, usernameToMatch As String) As PersonalizationStateInfoCollectionParametry
- pathToMatch
- String
Ścieżka strony do dopasowania.
- usernameToMatch
- String
Nazwa użytkownika zgodna z danymi personalizacji skojarzonymi ze stroną.
Zwraca
Element PersonalizationStateInfoCollection zawierający informacje o stanie personalizacji poszczególnych użytkowników.
Wyjątki
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.
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 systemem 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
Dotyczy
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.PersonalizationStateInfoCollectionPublic Shared Function FindUserState (pathToMatch As String, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollectionParametry
- 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
Element PersonalizationStateInfoCollection zawierający informacje o stanie personalizacji poszczególnych użytkowników.
Wyjątki
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.
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 systemem 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
Dotyczy
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla