SqlPersonalizationProvider.FindState Metod

Definition

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

Returnerar en samling som innehåller noll eller fler PersonalizationStateInfo-härledda objekt baserat på angivet omfång och parametrar.

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

Parametrar

scope
PersonalizationScope

En PersonalizationScope som anger 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.

Undantag

ArgumentException

pageIndex är mindre än noll.

-eller-

pageSize är mindre än eller lika med noll.

-eller-

Kombinationen av pageIndex och pageSize resulterar i ett värde som är större än Int32.MaxValue.

-eller-

PathToMatch är icke-null och är en tom sträng ("") efter trimning.

-eller-

Längden PathToMatch på är större än 256 tecken när värdet inte är-null.

-eller-

UsernameToMatch är icke-null och är en tom sträng efter trimning.

-eller-

Längden UsernameToMatch på är större än 256 tecken när värdet inte är-null.

ArgumentOutOfRangeException

Det scope angivna värdet är inte ett giltigt värde från PersonalizationScope uppräkningen.

Kommentarer

Uppsättningen returnerade objekt begränsas av parametrarna pageSize och pageIndex , där pageSize styr antalet poster som ska returneras och pageIndex styr 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 sorterade efter Path och Username, 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 "~/approot" PathToMatch anges egenskapen till "~/approot%".

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 egenskapsvärdet PathToMatch .

  • 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