Udostępnij za pośrednictwem

PersonalizationAdministration.GetCountOfUserState(String) Metoda

  • Odwołanie

Definicja

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

Zwraca liczbę elementów stanu personalizacji w bazowym magazynie danych, które istnieją dla określonego użytkownika.

public:
 static int GetCountOfUserState(System::String ^ usernameToMatch);
public static int GetCountOfUserState (string usernameToMatch);
static member GetCountOfUserState : string -> int
Public Shared Function GetCountOfUserState (usernameToMatch As String) As Integer

Parametry

usernameToMatch
String

Nazwa użytkownika skojarzona z informacjami o stanie personalizacji do pobrania.

Zwraca

Int32

Liczba elementów stanu personalizacji dla określonego użytkownika.

Wyjątki

ArgumentException

usernameToMatch jest pustym ciągiem ("") po przycinaniu.

-lub-

Dostawca dostawcy personalizacji zdefiniowanego w konfiguracji nie jest poprawnym typem.

-lub-

Długość ciągu dowolnego parametru jest większa niż 256 znaków.

ConfigurationErrorsException

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.

HttpException

Domyślny dostawca zwrócił liczbę ujemną dla liczby.

Uwagi

Ta metoda zwraca liczbę elementów personalizacji poszczególnych użytkowników w bazowym magazynie danych, które istnieją dla danego usernameToMatchelementu .

Należy pamiętać, że usernameToMatch parametr może zawierać symbole wieloznaczne. Ta metoda przekazuje symbole wieloznaczne 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 symbol wieloznaczny na częściowej nazwie użytkownika może mieć postać wieloznaczny 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%".

Parametr usernameToMatch może mieć wartość null. Jeśli ustawiono nullwartość , parametr jest ignorowany podczas wykonywania zapytań. Parametr usernameToMatch może mieć przecinki (,), ponieważ niektóre magazyny danych, takie jak te z uruchomionym programem Microsoft SQL Server, zezwalają na przecinki jako znaki wieloznaczne.

Dotyczy

Zobacz też