PersonalizationAdministration.FindInactiveUserState Methode

Definitie

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

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Retourneert een verzameling persoonlijke statusgegevens per gebruiker voor inactieve gebruikers, op basis van de opgegeven parameters.

Overloads

Name	Description
FindInactiveUserState(String, String, DateTime)	Retourneert een verzameling persoonlijke statusgegevens per gebruiker voor inactieve gebruikers, op basis van de opgegeven parameters.
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)	Retourneert een verzameling persoonlijke statusgegevens per gebruiker voor inactieve gebruikers, op basis van de opgegeven parameters.

FindInactiveUserState(String, String, DateTime)

Retourneert een verzameling persoonlijke statusgegevens per gebruiker voor inactieve gebruikers, op basis van de opgegeven parameters.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate);

public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState(string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate);

static member FindInactiveUserState : string * string * DateTime -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime) As PersonalizationStateInfoCollection

Parameters

pathToMatch: String

Het pad van de pagina dat moet worden vergeleken.

usernameToMatch: String

De gebruikersnaam die overeenkomt met de persoonlijke gegevens die aan de pagina zijn gekoppeld.

userInactiveSinceDate: DateTime

De laatste datum waarop de persoonlijke gegevens van een gebruiker zijn geopend.

Retouren

PersonalizationStateInfoCollection

Een PersonalizationStateInfoCollection met statusgegevens per gebruiker.

Uitzonderingen

ArgumentException

pathToMatch of usernameToMatch voor of na het bijsnijden is een lege tekenreeks ("").

– of –

De provider voor een personalisatieprovider die in de configuratie is gedefinieerd, is niet van het juiste type.

– of –

De lengte van de tekenreeks van een parameter is groter dan 256 tekens.

ConfigurationErrorsException

Er is een configuratie-uitzondering opgetreden bij het maken en initialiseren van een exemplaar van een van de geconfigureerde personalisatieproviders.

– of –

De standaardprovider voor persoonlijke instellingen die in de configuratie is gedefinieerd, is niet gevonden.

Opmerkingen

Deze methode retourneert een verzameling UserPersonalizationStateInfo exemplaren, statusgegevens per gebruiker, waarbij de pathToMatch parameterwaarde overeenkomt met het pad van een pagina, usernameToMatch overeenkomt met een gebruikersnaam met persoonlijke gegevens die aan die pagina zijn gekoppeld en de gebruikers als inactief worden beschouwd. Met andere woorden, voor elke geretourneerde record is de eigenschapswaarde van LastActivityDate de gebruiker kleiner dan of gelijk aan userInactiveSinceDate. De geretourneerde verzameling bevat alleen UserPersonalizationStateInfo exemplaren.

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 eigenschap eruit als 'John%'.

Met behulp van de standaardprovider voor persoonlijke instellingen worden de PersonalizationStateInfo-afgeleide objecten in alfabetische volgorde geretourneerd en gesorteerd op een combinatie van pad en gebruikersnaam in oplopende volgorde. De volgorde van de objecten in de verzameling wordt bepaald door de provider.

Als userInactiveSinceDate dat het is MaxValue, zijn de geretourneerde waarden van deze methode gelijk aan FindUserState.

Beide pathToMatch en usernameToMatch kunnen zijn null. De parameter usernameToMatch kan komma's (,) bevatten omdat sommige gegevensarchieven, zoals die waarop Microsoft SQL Server wordt uitgevoerd, komma's als jokertekens toestaan.

Zie ook

Van toepassing op

FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

Retourneert een verzameling persoonlijke statusgegevens per gebruiker voor inactieve gebruikers, op basis van de opgegeven parameters.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState(string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);

static member FindInactiveUserState : string * string * DateTime * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parameters

pathToMatch: String

Het pad van de pagina dat moet worden vergeleken.

usernameToMatch: String

De gebruikersnaam die overeenkomt met de persoonlijke gegevens die aan de pagina zijn gekoppeld.

userInactiveSinceDate: DateTime

De laatste datum waarop persoonlijke gegevens zijn geopend.

pageIndex: Int32

De op nul gebaseerde index van de pagina met resultaten die moeten worden geretourneerd.

pageSize: Int32

Het aantal records dat moet worden geretourneerd.

totalRecords: Int32

Het totale aantal beschikbare records.

Retouren

PersonalizationStateInfoCollection

Een PersonalizationStateInfoCollection met statusgegevens per gebruiker.

Uitzonderingen

ArgumentException

pathToMatch of usernameToMatch voor of na het bijsnijden is een lege tekenreeks ("").

– of –

pageIndex is kleiner dan nul

– of –

pageSize is kleiner dan of gelijk aan nul.

– of –

de combinatie van pageIndex en pageSize overschrijdt Int32.MaxValue.

– of –

De provider voor een personalisatieprovider die in de configuratie is gedefinieerd, is niet van het juiste type.

– of –

De lengte van de tekenreeks van een parameter is groter dan 256 tekens.

ConfigurationErrorsException

Er is een configuratie-uitzondering opgetreden bij het maken en initialiseren van een exemplaar van een van de geconfigureerde personalisatieproviders.

– of –

De standaardprovider voor persoonlijke instellingen die in de configuratie is gedefinieerd, is niet gevonden.

Opmerkingen

Deze methode retourneert een verzameling UserPersonalizationStateInfo exemplaren, statusgegevens per gebruiker, waarbij de pathToMatch parameterwaarde overeenkomt met het pad van een pagina, usernameToMatch overeenkomt met een gebruikersnaam met persoonlijke gegevens die aan die pagina zijn gekoppeld en de gebruikers als inactief worden beschouwd. Met andere woorden, voor elke geretourneerde record is de eigenschapswaarde van LastActivityDate de gebruiker kleiner dan of gelijk aan userInactiveSinceDate. De verzameling bevat alleen UserPersonalizationStateInfo exemplaren.

Deze methode geeft parameter-jokertekens door aan de onderliggende personalisatieprovider, dus hoe het gegevensarchief deze tekens verwerkt, is afhankelijk van hoe de provider tekens verwerkt, zoals een sterretje (*), een procentsymbool (%) of een onderstrepingsteken (_).

Als userInactiveSinceDate dat het is MaxValue, zijn de geretourneerde waarden van deze methode gelijk aan FindUserState.

De geretourneerde gegevens worden beperkt door pageIndex en pageSize, waarbij bepaalt welke pageIndex records moeten worden geretourneerd en pageSize het aantal records dat moet worden geretourneerd. Als pageIndex de waarde bijvoorbeeld is ingesteld op 0 en pageSize is ingesteld op 25, zijn de geretourneerde gegevens de eerste 25 vermeldingen. Als pageIndex de waarde is ingesteld op 1 en pageSize is ingesteld op 25, worden de geretourneerde gegevens 26 tot 50. De totalRecords parameter retourneert het totale aantal records dat beschikbaar is.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?