PersonalizationProvider.FindState Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls.WebParts

Zestaw:: System.Web.dll

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.

Po zastąpieniu w klasie pochodnej zwraca kolekcję zawierającą zero lub więcej PersonalizationStateInfoobiektów pochodnych na podstawie zakresu i określonych parametrów zapytania.

public:
 abstract System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query, int pageIndex, int pageSize, out int totalRecords);

abstract member FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public MustOverride Function FindState (scope As PersonalizationScope, query As PersonalizationStateQuery, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parametry

scope: PersonalizationScope

Element PersonalizationScope z informacjami o personalizacji do odpytowania. Ta wartość nie może być wartością null.

query: PersonalizationStateQuery

Element PersonalizationStateQuery zawierający zapytanie. Ta wartość może mieć wartość null.

pageIndex: Int32

Lokalizacja, w której uruchamia się zapytanie.

pageSize: Int32

Liczba rekordów do zwrócenia.

totalRecords: Int32

Całkowita liczba dostępnych rekordów.

Zwraca

PersonalizationStateInfoCollection

Obiekt PersonalizationStateInfoCollection zawierający zero lub więcej PersonalizationStateInfoobiektów pochodnych.

Uwagi

Ta metoda jest abstrakcyjną definicją metody administracyjnej do wykonywania zapytań dotyczących danych personalizacji. Implementacje pochodne powinny być zgodne z logiką opisaną poniżej.

Zestaw zwracanych elementów jest ograniczony przez pageIndex parametry i pageSize , gdzie pageSize ustawia liczbę rekordów do zwrócenia i pageIndex ustawia, które rekordy mają być zwracane. Na przykład wartość pageIndex 0 i pageSize z 25 zwróci pierwsze 25 wystąpień, a wartość pageIndex 1 i pageSize 25 zwróci wystąpienia 26–50. Jeśli chcesz pobrać wszystkie dostępne rekordy, ustaw wartość pageIndex 0 i pageSize na MaxValuewartość .

PersonalizationStateInfoObiekty pochodne są zwracane w kolejności alfabetycznej i sortowane według kombinacji ich Path wartości i Username właściwości, zarówno w kolejności rosnącej.

Ta metoda przekazuje symbole wieloznaczne zapytania do bazowego magazynu danych. Obsługa symboli wieloznacznych jest obecnie zależna od sposobu obsługi znaków przez każdego 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 parametr będzie wyglądać następująco: "John%".

Obowiązują następujące ograniczenia zapytania:

Jeśli podano tylko scope wartości i query jest null lub wszystkie właściwości zwracane querynull albo wartości domyślne, zwracane są wszystkie rekordy pasujące do wskazanego scope parametru.
PathToMatch Jeśli właściwość nie nullma wartości , zwracane rekordy są również filtrowane na podstawie ścieżek pasujących do PathToMatch wartości.
UsernameToMatch Jeśli właściwość nie nulljest , zwracane rekordy są również filtrowane na podstawie nazw użytkowników, które pasują do UsernameToMatch wartości właściwości.
UserInactiveSinceDate Jeśli właściwość nie jest równa MaxValuewartości , zwracane rekordy są również filtrowane w celu zwrócenia tylko tych rekordów skojarzonych z nieaktywnymi użytkownikami. Porównanie obejmuje rekordy, w których LastActivityDate właściwość jest mniejsza lub równa UserInactiveSinceDate właściwości.

Należy pamiętać, że ta metoda nie weryfikuje kombinacji parametrów zapytania. Na przykład kod może zażądać zestawu rekordów stanu personalizacji skojarzonych z określoną nazwą użytkownika w zakresie udostępnionym. Ponieważ nazwy użytkowników nie są skojarzone z informacjami udostępnionymi, zwracana kolekcja będzie pusta.

Kombinacje parametrów, które mają potencjał do zwrócenia kolekcji niepustej, obejmują:

Shared zakres w połączeniu z właściwością PathToMatch .
User zakres w połączeniu z wartościami dla dowolnych PathToMatchlub wszystkich właściwości , UsernameToMatchi UserInactiveSinceDate .

Dotyczy

Udostępnij za pośrednictwem