Udostępnij przez

SqlPersonalizationProvider.GetCountOfState Metoda

  • Odwołanie

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 informacje o personalizacji, które mają być odpytywane. Ta wartość nie może być nullwartością .

query
PersonalizationStateQuery

Element PersonalizationStateQuery zawierający zapytanie. Ta wartość może być następująca null: .

Zwraca

Int32

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

Wyjątki

ArgumentException

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

-lub-

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

-lub-

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

-lub-

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

ArgumentOutOfRangeException

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

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 programem SQL można wykonać wyszukiwanie symboli wieloznacznych na ścieżce częściowej 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 ciągu "~/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 właściwość i query jest null lub wszystkie właściwości w query wartościach zwracanych null lub domyślnych, 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 pasujących do PathToMatch wartości właściwości.

  • Jeśli parametr UsernameToMatch nie nullma wartości , 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 MaxValue, zwracane rekordy są również filtrowane, aby zwrócić tylko te rekordy skojarzone 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