PersonalizationProvider.GetCountOfState Methode

Definitie

Naamruimte:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Wanneer deze wordt overschreven in een afgeleide klasse, wordt het aantal rijen in het onderliggende gegevensarchief geretourneerd dat binnen het opgegeven bereik bestaat.

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

Parameters

scope
PersonalizationScope

Een PersonalizationScope van de persoonlijke gegevens die moeten worden opgevraagd. Deze waarde kan niet zijn null.

query
PersonalizationStateQuery

Een PersonalizationStateQuery met een query. Deze waarde kan zijn null.

Retouren

Int32

Het aantal rijen in het onderliggende gegevensarchief dat bestaat voor de opgegeven scope parameter.

Opmerkingen

Deze methode is de abstracte definitie van een beheermethode voor het ophalen van tellingen van persoonlijke gegevens. Afgeleide implementaties moeten de hieronder beschreven logica volgen.

Met deze methode worden query-jokertekens doorgegeven aan het onderliggende gegevensarchief. Ondersteuning voor jokertekens is momenteel afhankelijk van de manier waarop elke provider tekens verwerkt, zoals een sterretje (*), een procentsymbool (%) of een onderstrepingsteken (_).

Normaal gesproken kunt u voor sql-compatibele gegevensarchieven een zoekopdracht met jokertekens uitvoeren op een gedeeltelijk pad, waarbij het jokerteken aan het begin, het einde of het midden van de tekenreekstekst in de PathToMatch eigenschap wordt weergegeven. Als u bijvoorbeeld alle paden wilt vinden die beginnen met ~/vdir, wordt de PathToMatch eigenschap ingesteld op '~/vdir%'.

Op dezelfde manier kan bij een zoekopdracht met jokertekens op een gedeeltelijke gebruikersnaam het jokerteken op elk punt in de tekenreeks van de UsernameToMatch eigenschap worden weergegeven. Als u bijvoorbeeld alle gebruikersnamen wilt zoeken die beginnen met 'John', ziet de UsernameToMatch parameter eruit als 'John%'.

De volgende querybeperkingen zijn van toepassing:

  • Als alleen scope wordt opgegeven en querynull of alle eigenschappen bij query het retourneren of null standaardwaarden zijn, worden alle records die overeenkomen met de opgegeven scope parameter geteld.

  • Als de PathToMatch eigenschap niet nullis, worden de getelde records ook gefilterd op basis van paden die overeenkomen met de PathToMatch waarde.

  • Als de UsernameToMatch eigenschap niet nullis, worden de getelde records ook gefilterd op basis van gebruikersnamen die overeenkomen met de UsernameToMatch eigenschapswaarde.

  • Als de UserInactiveSinceDate eigenschap niet gelijk is aan MaxValue, worden de getelde records ook gefilterd om alleen de records te retourneren die zijn gekoppeld aan inactieve gebruikers. De vergelijking bevat records waarbij de LastActivityDate eigenschap kleiner is dan of gelijk is aan de UserInactiveSinceDate eigenschap.

Houd er rekening mee dat deze methode geen combinaties van queryparameters valideert. Code kan bijvoorbeeld een telling aanvragen van persoonlijke statusrecords die zijn gekoppeld aan een specifieke gebruikersnaam in het gedeelde bereik. Omdat gebruikersnamen niet zijn gekoppeld aan gedeelde gegevens, is het geretourneerde aantal nul.

Parametercombinaties die het potentieel hebben om een aantal niet-nul te retourneren, zijn onder andere:

Van toepassing op