Sdílet prostřednictvím

PersonalizationProvider.FindState Metoda

  • Reference

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

Obsahující 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

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

Poznámky

Tato metoda je abstraktní definicí metody správy pro dotazování dat přizpůsobení. Odvozené implementace by se měly řídit logikou popsanou níže.

Sada vrácených položek je omezena pageIndex parametry a pageSize , kde pageSize nastaví počet záznamů, které se mají vrátit, a pageIndex nastaví, které záznamy se mají vrátit. Například pageIndex hodnoty 0 a a pageSize z 25 by vrátily prvních 25 výskytů, zatímco pageIndex hodnoty 1 a pageSize 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.

Odvozené PersonalizationStateInfoobjekty jsou vráceny v abecedním pořadí a seřazeny podle kombinace jejich Path a Username hodnot vlastností, a to ve vzestupném pořadí.

Tato metoda předá zástupné znaky dotazu podkladovému úložišti 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, který se zobrazuje na začátku, na konci nebo uprostřed textu hledaného řetězce ve PathToMatch vlastnosti . Pokud například chcete najít všechny cesty, které začínají na ~/vdir, PathToMatch vlastnost by byla nastavená na ~/vdir%.

Podobně při hledání pomocí zástupných znaků u částečného uživatelského jména se zástupný znak může objevit v libovolném bodě textového UsernameToMatch řetězce vlastnosti. 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 zadaný pouze scope parametr a query je null nebo všechny vlastnosti vrátí querynull jednu 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 se také filtrují na základě cest, které odpovídají dané hodnotěPathToMatch.

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

  • Pokud se UserInactiveSinceDate vlastnost nerovná hodnotě MaxValue, vyfiltrují se také vrácené záznamy tak, aby vracely jenom ty záznamy přidružené k neaktivním uživatelům. Porovnání zahrnuje záznamy, ve LastActivityDate kterých 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ů 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, vrácená kolekce by byla prázdná.

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

Platí pro