Share via

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 zdefiniowany w konfiguracji nie jest prawidłowym 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 dla poszczególnych użytkowników w bazowym magazynie danych, które istnieją dla danego usernameToMatchobiektu .

Należy pamiętać, że usernameToMatch parametr może zawierać symbole wieloznaczne. Ta metoda przekazuje symbole wieloznaczne do bazowego magazynu danych. Obsługa znaków 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 SQL symbol wieloznaczny 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%".

Parametr usernameToMatch może mieć wartość null. W przypadku ustawienia wartości nullparametr zostanie zignorowany podczas wykonywania zapytań. Parametr usernameToMatch może mieć przecinki (,), ponieważ niektóre magazyny danych, takie jak te z systemem Microsoft SQL Server, zezwalają na przecinki jako symbole wieloznaczne.

Dotyczy

Zobacz też