SqlPersonalizationProvider.FindState Metoda

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Vrátí kolekci obsahující nula nebo více PersonalizationStateInfoodvozených objektů na základě zadaného oboru a parametrů.

public:
 override System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public override System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query, int pageIndex, int pageSize, out int totalRecords);

override this.FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public Overrides Function FindState (scope As PersonalizationScope, query As PersonalizationStateQuery, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parametry

scope

PersonalizationScope

A PersonalizationScope označující informace o přizpůsobení, které se mají dotazovat. Tato hodnota nemůže být null.

query

PersonalizationStateQuery

Obsahuje PersonalizationStateQuery dotaz. Tato hodnota může být null.

pageIndex

Int32

Umístění, kde dotaz začíná.

pageSize

Int32

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

totalRecords

Int32

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

Návraty

PersonalizationStateInfoCollection

Objekt PersonalizationStateInfoCollection obsahující nula nebo více PersonalizationStateInfoodvozených objektů.

Výjimky

ArgumentException

Hodnota pageIndex je menší než nula.

-nebo-

pageSize je menší než nebo rovno nule.

-nebo-

Kombinace pageIndex a pageSize výsledkem je hodnota větší než Int32.MaxValue.

-nebo-

PathToMatch je non-null a je prázdný řetězec ("") po oříznutí.

-nebo-

PathToMatch Pokud hodnota nenínull, délka je větší než 256 znaků.

-nebo-

UsernameToMatch je non-null a je prázdný řetězec po oříznutí.

-nebo-

UsernameToMatch Pokud hodnota nenínull, délka je větší než 256 znaků.

ArgumentOutOfRangeException

Zadaná scope hodnota není platná hodnota z výčtu PersonalizationScope .

Poznámky

Sada vrácených položek je omezena pageSize parametry a pageIndex , kde pageSize řídí počet záznamů, které se mají vrátit, a pageIndex určuje, které záznamy se mají vrátit. Například hodnoty pageIndex 0 a a pageSize 25 by vrátily prvních 25 výskytů, zatímco pageIndex hodnoty 1 a pageSize a 25 by vrátily výskyty 26–50. Pokud chcete načíst všechny dostupné záznamy, nastavte pageIndex na 0 a pageSize na MaxValue.

Objekty PersonalizationStateInfoodvozené od -jsou vráceny v abecedním pořadí seřazené podle Path a Username, a to ve vzestupném pořadí.

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. Například pokud chcete najít všechny cesty, které začínají na ~/approot, PathToMatch vlastnost by byla nastavena na "~/approot%".

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 parametr by vypadal takto: "John%".

Platí následující omezení dotazu:

• Pokud je k dispozici pouze scope hodnota a query je null nebo všechny vlastnosti vrátí querynull výchozí hodnoty, vrátí se všechny záznamy odpovídající zadanému scope parametru.

• PathToMatch Pokud vlastnost není null, jsou vrácené záznamy také filtrovány na základě cest, které odpovídají hodnotě PathToMatch vlastnosti.

• UsernameToMatch Pokud vlastnost není null, jsou vrácené záznamy také filtrovány na základě uživatelských jmen, která odpovídají hodnotě UsernameToMatch vlastnosti.

• Pokud se UserInactiveSinceDate vlastnost nerovná MaxValue, vracené záznamy se také vyfiltrují tak, aby vracely jenom ty záznamy přidružené k neaktivním uživatelům. Porovnání zahrnuje záznamy, u kterých LastActivityDate je vlastnost menší nebo rovna UserInactiveSinceDate vlastnosti.

Všimněte si, že tato metoda neověřuje kombinace parametrů dotazu. Kód může například požadovat sadu záznamů stavu přizpůsobení přidružených ke konkrétnímu uživatelskému jménu ve sdíleném oboru. Vzhledem k tomu, že uživatelská jména nejsou přidružená ke sdíleným informacím, vrácená kolekce by byla prázdná.

Mezi kombinace parametrů, které mají potenciál vrátit neprázdnou kolekci, patří:

• Shared rozsah v kombinaci s PathToMatch.

• User scope v kombinaci s hodnotami pro některé nebo všechny PathToMatchvlastnosti , UsernameToMatcha UserInactiveSinceDate .