Taal

PersonalizationProvider.FindState Methode

Definitie

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

Wanneer deze wordt overschreven in een afgeleide klasse, wordt een verzameling geretourneerd die nul of meer PersonalizationStateInfoafgeleide objecten bevat op basis van bereik en specifieke queryparameters.

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

Parameters

scope
PersonalizationScope

Een PersonalizationScope met 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.

pageIndex
Int32

De locatie waar de query wordt gestart.

pageSize
Int32

Het aantal records dat moet worden geretourneerd.

totalRecords
Int32

Het totale aantal beschikbare records.

Retouren

PersonalizationStateInfoCollection

Een PersonalizationStateInfoCollection met nul of meer PersonalizationStateInfoafgeleide objecten.

Opmerkingen

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

De set geretourneerde items wordt beperkt door de pageIndex en pageSize parameters, waarbij pageSize het aantal records wordt ingesteld dat moet worden geretourneerd en pageIndex wordt ingesteld welke records moeten worden geretourneerd. Een van 0 en een pageIndex van 25 retourneert bijvoorbeeld pageSize de eerste 25 exemplaren, terwijl een pageIndex van 1 en een pageSize van 25 exemplaren 26-50 retourneert. Als u alle beschikbare records wilt ophalen, stelt u in op pageIndex 0 en pageSize op MaxValue.

De PersonalizationStateInfo-afgeleide objecten worden in alfabetische volgorde geretourneerd en gesorteerd op een combinatie van hun Path en Username eigenschapswaarden, beide in oplopende volgorde.

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

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

  • Als de UsernameToMatch eigenschap niet nullis, 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 set persoonlijke statusrecords aanvragen die zijn gekoppeld aan een specifieke gebruikersnaam in het gedeelde bereik. Omdat gebruikersnamen niet zijn gekoppeld aan gedeelde gegevens, is de geretourneerde verzameling leeg.

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

Van toepassing op