Udostępnij za pośrednictwem

SqlPersonalizationProvider.GetCountOfState Metoda

Definicja

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

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

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

Parametry

scope
PersonalizationScope

Element PersonalizationScope wskazujący dane 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.

Zwraca

Int32

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

Wyjątki

ArgumentException

PathToMatch jest inny niżnull i jest pustym ciągiem ("") po przycinaniu.

— lub —

Długość PathToMatch wartości jest większa niż 256 znaków, gdy wartość nie jestnull.

— lub —

UsernameToMatch jest inny niżnull i jest pustym ciągiem po przycinaniu.

— lub —

Długość UsernameToMatch wartości jest większa niż 256 znaków, gdy wartość nie jestnull.

ArgumentOutOfRangeException

Określona scope wartość nie jest prawidłową wartością PersonalizationScope z wyliczenia.

Uwagi

Ta metoda przekazuje symbole wieloznaczne zapytania do bazowego magazynu danych. Obsługa symboli wieloznacznych jest obecnie zależna od tego, jak każdy dostawca obsługuje znaki, takie jak gwiazdka (*), symbol procentu (%) lub podkreślenie (_).

Zwykle w przypadku magazynów danych zgodnych z językiem SQL można wykonać wyszukiwanie wieloznaczne 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 "~/approot", PathToMatch właściwość zostanie ustawiona na "~/approot%".

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 jest podana tylko scope wartość 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 nulljest , zwracane rekordy są również filtrowane na podstawie ścieżek, które pasują do PathToMatch wartości właściwości.

  • UsernameToMatch Jeśli parametr nie nullma wartości , zwracane rekordy są również filtrowane na podstawie nazw użytkowników, które są zgodne z wartością UsernameToMatch 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ć liczby rekordów stanu skojarzonych z nieaktywnymi użytkownikami w zakresie udostępnionym. Ponieważ nie ma pojęcia nieaktywnych dostosowań, zwracana liczba będzie równa zero.

Kombinacje parametrów, które mogą zwrócić niepustą kolekcję, obejmują:

Dotyczy