PersonalizationProvider.GetCountOfState Metoda

  • Odwołanie

Definicja

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

Po zastąpieniu w klasie pochodnej zwraca liczbę wierszy w bazowym magazynie danych, które istnieją w określonym zakresie.

public:
 abstract int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);
public abstract int GetCountOfState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);
abstract member GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int
Public MustOverride Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

Parametry

scope
PersonalizationScope

A PersonalizationScope z informacji o personalizacji, które mają być odpytywane. Ta wartość nie może być wartością null.

query
PersonalizationStateQuery

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

Zwraca

Int32

Liczba wierszy w bazowym magazynie danych, które istnieją dla określonego scope parametru.

Uwagi

Ta metoda jest abstrakcyjną definicją metody administracyjnej do pobierania liczby danych personalizacji. Implementacje pochodne powinny być zgodne z logiką opisaną poniżej.

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 parametr i query jest null lub wszystkie właściwości zwracane querynull albo wartości domyślne, wszystkie rekordy pasujące do wskazanego scope parametru są liczone.

  • PathToMatch Jeśli właściwość nie nullma wartości , zliczane rekordy są również filtrowane na podstawie ścieżek pasujących do PathToMatch wartości.

  • UsernameToMatch Jeśli właściwość nie nulljest , zliczane 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 , zliczane 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ć liczby 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 liczba będzie równa zero.

Kombinacje parametrów, które mogą zwracać liczbę niezerową, obejmują:

Dotyczy