Sdílet prostřednictvím

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 indikující informace 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ů.

Výjimky

ArgumentException

Hodnota pageIndex je menší než nula.

nebo

pageSize je menší než nebo rovno nule.

nebo

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

nebo

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

nebo

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

nebo

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

nebo

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

ArgumentOutOfRangeException

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

Poznámky

Sada vrácených položek je omezená pageSize parametry a pageIndex parametry, kde pageSize řídí počet záznamů, které mají vrátit, a pageIndex určuje, které záznamy 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í seřazené podle Path a Username, 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. Pokud například chcete najít všechny cesty začínající na ~/approot, PathToMatch vlastnost by byla nastavena na ~/approot%".

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

  • 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