PersonalizationProvider.GetCountOfState Metod

Definition

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

När det åsidosätts i en härledd klass returneras antalet rader i det underliggande datalagret som finns inom det angivna omfånget.

public:
 abstract int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);
public abstract int GetCountOfState(System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);
abstract member GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int
Public MustOverride Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

Parametrar

scope
PersonalizationScope

En PersonalizationScope av de anpassningsuppgifter 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.

Returer

Int32

Antalet rader i det underliggande datalagret som finns för den angivna scope parametern.

Kommentarer

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

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, räknas alla poster som matchar den angivna scope parametern.

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

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

  • Om egenskapen UserInactiveSinceDate inte är lika MaxValuemed filtreras även de räknade 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 ett antal personanpassningstillståndsposter som är associerade med ett specifikt användarnamn i det delade omfånget. Eftersom användarnamn inte är associerade med delad information blir det returnerade antalet noll.

Parameterkombinationer som kan returnera ett antal som inte är noll är:

Gäller för