Sdílet prostřednictvím

PersonalizationProvider.FindState Metoda

Definice

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

Při přepsání v odvozené třídě vrátí kolekci obsahující nula nebo více PersonalizationStateInfoodvozených objektů na základě oboru a konkrétních parametrů dotazu.

public:
 abstract 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 abstract 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);
abstract member FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public MustOverride 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 s informacemi o přizpůsobení, které se mají dotazovat. Tato hodnota nemůže být null.

query
PersonalizationStateQuery

A PersonalizationStateQuery obsahující dotaz. Tato hodnota může být null.

pageIndex
Int32

Umístění, kde se dotaz spouští.

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 obsahující nula nebo více PersonalizationStateInfoodvozených objektů.

Poznámky

Tato metoda je abstraktní definicí metody správy pro dotazování osobních údajů. Odvozené implementace by měly dodržovat logiku popsanou níže.

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

PersonalizationStateInfoOdvozené objekty jsou vráceny v abecedním pořadí a seřazeny kombinací jejich Path a Username hodnot vlastností, a to jak ve vzestupném pořadí.

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

V případě úložišť dat kompatibilních s SQL můžete obvykle provést vyhledávání se zástupnými znaky na částečné cestě se zástupnými znaky, které se zobrazí na začátku, na konci nebo uprostřed textu vyhledávacího řetězce ve PathToMatch vlastnosti. Chcete-li například najít všechny cesty začínající na ~/vdir, PathToMatch vlastnost by byla nastavena na ~/vdir%".

Podobně může vyhledávání zástupných znaků na částečném uživatelském jménu obsahovat zástupný znak 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 bude parametr vypadat takto: "John%".

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

  • Pokud je k dispozici pouze scope a query jsou null nebo všechny vlastnosti při query vrácení buď null nebo výchozí hodnoty, vrátí se všechny záznamy odpovídající zadanému scope parametru.

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

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

  • Pokud se UserInactiveSinceDate vlastnost nerovná MaxValue, vrácené záznamy jsou také filtrovány tak, aby vracely pouze ty záznamy přidružené k neaktivním uživatelům. Porovnání zahrnuje záznamy, ve 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žádat o sadu záznamů o stavu přizpůsobení přidružené 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, bude vrácená kolekce prázdná.

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

Platí pro