SqlPersonalizationProvider.GetCountOfState Methode

Definitie

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

Retourneert een telling van het aantal rijen in het onderliggende gegevensarchief dat bestaat voor de opgegeven scope parameter.

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

Parameters

scope
PersonalizationScope

Een PersonalizationScope vermelding die aangeeft welke persoonlijke gegevens 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.

Uitzonderingen

ArgumentException

PathToMatch is niet ennull is een lege tekenreeks ("") na het bijsnijden.

– of –

De lengte van PathToMatch 256 tekens is groter dan 256 tekens wanneer de waarde niet isnull.

– of –

UsernameToMatch is niet ennull is een lege tekenreeks na het bijsnijden.

– of –

De lengte van UsernameToMatch 256 tekens is groter dan 256 tekens wanneer de waarde niet isnull.

ArgumentOutOfRangeException

De scope opgegeven waarde is geen geldige waarde uit de PersonalizationScope opsomming.

Opmerkingen

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 '~/approot', wordt de PathToMatch eigenschap ingesteld op '~/approot%'.

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

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

  • Als dit niet nullhet UsernameToMatch is, worden de geretourneerde records ook gefilterd op basis van gebruikersnamen die overeenkomen met de UsernameToMatch eigenschapswaarde.

  • Als de UserInactiveSinceDate eigenschap niet gelijk is aan MaxValue, worden de geretourneerde 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 statusrecords die zijn gekoppeld aan inactieve gebruikers in het gedeelde bereik. Omdat er geen concept van inactieve aanpassingen is, is het geretourneerde aantal nul.

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

Van toepassing op