PersonalizationProvider.FindState Metod

Definition

Namnområde:
System.Web.UI.WebControls.WebParts
Sammansättning:
System.Web.dll

När den åsidosätts i en härledd klass returneras en samling som innehåller noll eller fler PersonalizationStateInfo-härledda objekt baserat på omfång och specifika frågeparametrar.

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

Parametrar

scope
PersonalizationScope

A PersonalizationScope med den anpassningsinformation som ska efterfrågas. Det här värdet får inte vara null.

query
PersonalizationStateQuery

En PersonalizationStateQuery som innehåller en fråga. Det här värdet kan vara null.

pageIndex
Int32

Platsen där frågan startar.

pageSize
Int32

Antalet poster som ska returneras.

totalRecords
Int32

Det totala antalet tillgängliga poster.

Returer

PersonalizationStateInfoCollection

En PersonalizationStateInfoCollection som innehåller noll eller fler PersonalizationStateInfo-härledda objekt.

Kommentarer

Den här metoden är den abstrakta definitionen av en administrativ metod för att fråga efter personanpassningsdata. Härledda implementeringar bör följa den logik som beskrivs nedan.

Uppsättningen returnerade objekt begränsas av parametrarna pageIndex och pageSize , där pageSize anger antalet poster som ska returneras och pageIndex anger vilka poster som ska returneras. Till exempel skulle en pageIndex av 0 och en pageSize av 25 returnera de första 25 förekomsterna, medan en pageIndex av 1 och en pageSize av 25 skulle returnera förekomster 26-50. Om du vill hämta alla tillgängliga poster anger du pageIndex till 0 och pageSize till MaxValue.

- PersonalizationStateInfohärledda objekt returneras i alfabetisk ordning och sorteras efter en kombination av deras Path och Username egenskapsvärden, båda i stigande ordning.

Den här metoden skickar jokertecken för frågor till det underliggande datalagret. Stöd för jokertecken beror för närvarande på hur varje provider hanterar tecken, till exempel en asterisk (*), en procentsymbol (%) eller ett understreck (_).

För SQL-kompatibla datalager kan du normalt utföra en sökning med jokertecken på en partiell sökväg med jokertecknet som visas i början, slutet eller i mitten av söksträngstexten PathToMatch i egenskapen. Om du till exempel vill hitta alla sökvägar som börjar med "~/vdir" PathToMatch skulle egenskapen vara inställd på "~/vdir%".

På samma sätt kan en jokerteckensökning på ett partiellt användarnamn få jokertecknet att visas när som helst i egenskapens UsernameToMatch textsträng. Om du till exempel vill hitta alla användarnamn som börjar med "John" ser parametern UsernameToMatch ut som "John%".

Följande frågebegränsningar gäller:

  • Om endast scope anges, och query är null eller alla egenskaper vid query retur antingen null eller standardvärden, returneras alla poster som matchar den angivna scope parametern.

  • Om egenskapen PathToMatch inte nullär filtreras även de returnerade posterna baserat på sökvägar som matchar PathToMatch värdet.

  • Om egenskapen UsernameToMatch inte nullär filtreras även de returnerade posterna baserat på användarnamn som matchar egenskapsvärdet UsernameToMatch .

  • Om egenskapen UserInactiveSinceDate inte är lika MaxValuemed filtreras även de returnerade posterna för att endast returnera de poster som är associerade med inaktiva användare. Jämförelsen innehåller poster där egenskapen LastActivityDate är mindre än eller lika med UserInactiveSinceDate egenskapen.

Observera att den här metoden inte validerar kombinationer av frågeparametrar. Kod kan till exempel begära en uppsättning personanpassningstillståndsposter som är associerade med ett specifikt användarnamn i det delade omfånget. Eftersom användarnamn inte är associerade med delad information skulle den returnerade samlingen vara tom.

Parameterkombinationer som kan returnera en icke-tom samling är:

Gäller för