PersonalizationAdministration.GetCountOfUserState(String) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí počet položek stavu přizpůsobení v podkladovém úložišti dat, které existují pro zadaného uživatele.
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
Uživatelské jméno přidružené k informacím o stavu přizpůsobení, které se mají načíst.
Návraty
Počet položek stavu přizpůsobení pro zadaného uživatele.
Výjimky
usernameToMatch
je prázdný řetězec ("") po oříznutí.
-nebo-
Zprostředkovatel pro zprostředkovatele přizpůsobení definovaný v konfiguraci není správného typu.
-nebo-
Délka řetězce libovolného parametru je větší než 256 znaků.
Při pokusu o vytvoření a inicializaci instance jednoho z nakonfigurovaných zprostředkovatelů přizpůsobení došlo k výjimce konfigurace.
-nebo-
Výchozí zprostředkovatel přizpůsobení definovaný v konfiguraci nebyl nalezen.
Výchozí zprostředkovatel vrátil záporné číslo pro počet.
Poznámky
Tato metoda vrátí počet položek přizpůsobení podle uživatele v podkladovém úložišti dat, které existují pro daný usernameToMatch
objekt .
Všimněte si usernameToMatch
, že parametr může obsahovat zástupné znaky. Tato metoda předává zástupné znaky do podkladového úložiště dat. Podpora zástupných znaků v současné době závisí na tom, jak jednotliví zprostředkovatelé zpracovávají znaky, jako je hvězdička (*), symbol procenta (%) nebo podtržítko (_).
V případě úložišť dat kompatibilních s SQL může vyhledávání se zástupnými znaky u částečného uživatelského jména zobrazovat v libovolném bodě v textovém řetězci UsernameToMatch vlastnosti. Pokud například chcete najít všechna uživatelská jména začínající na "John", UsernameToMatch parametr by vypadal takto: "John%".
Parametrem usernameToMatch
může být null
. Pokud je nastavená na null
, parametr se při provádění dotazů ignoruje. Parametr usernameToMatch
může obsahovat čárky (,), protože některá úložiště dat, například ta, na kterých běží Microsoft SQL Server, umožňují čárky jako zástupné znaky.