Sdílet prostřednictvím

PersonalizationAdministration.FindInactiveUserState Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Vrátí kolekci informací o stavu přizpůsobení jednotlivých uživatelů pro neaktivní uživatele na základě zadaných parametrů.

Přetížení

FindInactiveUserState(String, String, DateTime)

Vrátí kolekci informací o stavu přizpůsobení jednotlivých uživatelů pro neaktivní uživatele na základě zadaných parametrů.
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

Vrátí kolekci informací o stavu přizpůsobení jednotlivých uživatelů pro neaktivní uživatele na základě zadaných parametrů.

FindInactiveUserState(String, String, DateTime)

Vrátí kolekci informací o stavu přizpůsobení jednotlivých uživatelů pro neaktivní uživatele na základě zadaných parametrů.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate);
static member FindInactiveUserState : string * string * DateTime -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime) As PersonalizationStateInfoCollection

Parametry

pathToMatch
String

Cesta stránky, která se má shodovat.

usernameToMatch
String

Uživatelské jméno, které se má shodovat s daty přizpůsobení přidružené ke stránce.

userInactiveSinceDate
DateTime

Datum posledního přístupu k informacím o přizpůsobení uživatele.

Návraty

PersonalizationStateInfoCollection

A PersonalizationStateInfoCollection , který obsahuje informace o stavu přizpůsobení jednotlivých uživatelů.

Výjimky

ArgumentException

pathToMatch nebo usernameToMatch před nebo po oříznutí je prázdný řetězec ("").

-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ů.

ConfigurationErrorsException

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.

Poznámky

Tato metoda vrátí kolekci UserPersonalizationStateInfo instancí, informace o stavu přizpůsobení jednotlivých uživatelů, kde pathToMatch hodnota parametru odpovídá cestě stránky, odpovídá uživatelskému jménu, usernameToMatch které má data přizpůsobení přidružená k dané stránce, a uživatelé jsou považováni za neaktivní. Jinými slovy, pro každý vrácený záznam je hodnota vlastnosti uživatele LastActivityDate menší nebo rovna userInactiveSinceDate. Vrácená kolekce obsahuje pouze UserPersonalizationStateInfo instance.

Tato metoda předá zástupné znaky dotazu do podkladového úložiště dat. Podpora zástupných znaků v současné době závisí na tom, jak každý zprostředkovatel zpracovává znaky, jako je hvězdička (*), symbol procenta (%) nebo podtržítko (_).

Za normálních okolností můžete u úložišť dat kompatibilních s SQL provádět vyhledávání pomocí zástupných znaků na částečné cestě se zástupným znakem zobrazeným na začátku, konci nebo uprostřed textu hledaného řetězce ve PathToMatch vlastnosti. Pokud například chcete najít všechny cesty začínající na ~/vdir, PathToMatch vlastnost by byla nastavena na ~/vdir%.

Podobně vyhledávání se zástupnými znaky u částečného uživatelského jména může mít v libovolném bodě v textovém řetězci UsernameToMatch vlastnosti zástupný znak. Pokud například chcete najít všechna uživatelská jména začínající na "John", UsernameToMatch bude vlastnost vypadat takto: "John%".

Pomocí výchozího zprostředkovatele PersonalizationStateInfopřizpůsobení jsou objekty odvozené od -vráceny v abecedním pořadí a seřazeny podle kombinace cesty a uživatelského jména ve vzestupném pořadí. Pořadí objektů v kolekci určuje poskytovatel.

Pokud userInactiveSinceDate je MaxValue, pak vrácené hodnoty z této metody jsou ekvivalentní hodnotě FindUserState.

Obě a pathToMatchusernameToMatch mohou být null. Parametr usernameToMatch může obsahovat čárky (,), protože některá úložiště dat, například úložiště microsoft SQL Server, umožňují čárky jako zástupné znaky.

Viz také

Platí pro

FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

Vrátí kolekci informací o stavu přizpůsobení jednotlivých uživatelů pro neaktivní uživatele na základě zadaných parametrů.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);
static member FindInactiveUserState : string * string * DateTime * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parametry

pathToMatch
String

Cesta stránky, která se má shodovat.

usernameToMatch
String

Uživatelské jméno, které se má shodovat s daty přizpůsobení přidružené ke stránce.

userInactiveSinceDate
DateTime

Informace o přizpůsobení posledního data byly přístupné.

pageIndex
Int32

Index stránky výsledků, který se má vrátit na základě nuly.

pageSize
Int32

Počet záznamů, které se mají vrátit.

totalRecords
Int32

Celkový počet dostupných záznamů.

Návraty

PersonalizationStateInfoCollection

A PersonalizationStateInfoCollection , který obsahuje informace o stavu přizpůsobení jednotlivých uživatelů.

Výjimky

ArgumentException

pathToMatch nebo usernameToMatch před nebo po oříznutí je prázdný řetězec ("").

-nebo-

pageIndex je menší než nula.

-nebo-

pageSize je menší než nebo rovno nule.

-nebo-

kombinace pageIndex a pageSize překračuje Int32.MaxValue.

-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ů.

ConfigurationErrorsException

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.

Poznámky

Tato metoda vrátí kolekci UserPersonalizationStateInfo instancí, informace o stavu přizpůsobení jednotlivých uživatelů, kde pathToMatch hodnota parametru odpovídá cestě stránky, odpovídá uživatelskému jménu, usernameToMatch které má data přizpůsobení přidružená k dané stránce, a uživatelé jsou považováni za neaktivní. Jinými slovy, pro každý vrácený záznam je hodnota vlastnosti uživatele LastActivityDate menší nebo rovna userInactiveSinceDate. Kolekce obsahuje pouze UserPersonalizationStateInfo instance.

Tato metoda předává zástupné znaky parametrů základnímu zprostředkovateli přizpůsobení, takže způsob, jakým úložiště dat tyto znaky zpracovává, závisí na tom, jak zprostředkovatel zpracovává znaky, jako je hvězdička (*), symbol procenta (%) nebo podtržítko (_).

Za normálních okolností můžete u úložišť dat kompatibilních s SQL provádět vyhledávání pomocí zástupných znaků na částečné cestě se zástupným znakem zobrazeným na začátku, konci nebo uprostřed textu hledaného řetězce ve PathToMatch vlastnosti. Pokud například chcete najít všechny cesty začínající na ~/vdir, PathToMatch vlastnost by byla nastavena na ~/vdir%.

Podobně vyhledávání se zástupnými znaky u částečného uživatelského jména může mít v libovolném bodě v textovém řetězci UsernameToMatch vlastnosti zástupný znak. Pokud například chcete najít všechna uživatelská jména začínající na "John", UsernameToMatch bude vlastnost vypadat takto: "John%".

Pomocí výchozího zprostředkovatele PersonalizationStateInfopřizpůsobení jsou objekty odvozené od -vráceny v abecedním pořadí a seřazeny podle kombinace cesty a uživatelského jména ve vzestupném pořadí. Pořadí objektů v kolekci určuje poskytovatel.

Pokud userInactiveSinceDate je MaxValue, pak vrácené hodnoty z této metody jsou ekvivalentní hodnotě FindUserState.

Obě a pathToMatchusernameToMatch mohou být null. Parametr usernameToMatch může obsahovat čárky (,), protože některá úložiště dat, například úložiště, na kterých běží Microsoft SQL Server, umožňují čárky jako zástupné znaky.

Vrácená data jsou omezena pageIndex a pageSize, kde pageIndex určuje, které záznamy se mají vrátit, a pageSize řídí počet záznamů, které se mají vrátit. Pokud pageIndex by například byla nastavena hodnota 0 a pageSize byla nastavena na hodnotu 25, vrácená data by byla prvních 25 položek. Pokud pageIndex byla nastavena hodnota 1 a pageSize byla nastavena na hodnotu 25, vrácená data by byla položky 26 až 50. Parametr totalRecords vrátí celkový počet dostupných záznamů.

Viz také

Platí pro