PersonalizationAdministration.FindInactiveUserState Méthode

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

Paramètres

Retours

PersonalizationStateInfoCollection qui contient les informations d'état de personnalisation par utilisateur.

Exceptions

Remarques

Cette méthode retourne une collection d’instances, des informations d’état de UserPersonalizationStateInfo personnalisation par utilisateur où la valeur du pathToMatch paramètre correspond au chemin d’accès d’une page, usernameToMatch correspond à un nom d’utilisateur qui a des données de personnalisation associées à cette page et les utilisateurs sont considérés comme inactifs. En d’autres termes, pour chaque enregistrement retourné, la valeur de propriété de LastActivityDate l’utilisateur est inférieure ou égale à userInactiveSinceDate. La collection retournée contient uniquement UserPersonalizationStateInfo des instances.

Cette méthode transmet des caractères génériques de requête au magasin de données sous-jacent. La prise en charge des caractères génériques dépend actuellement de la façon dont chaque fournisseur gère des caractères tels qu’un astérisque (*), un symbole de pourcentage (%) ou un trait de soulignement (_).

Normalement, pour les magasins de données compatibles SQL, vous pouvez effectuer une recherche générique sur un chemin d’accès partiel avec le caractère générique qui apparaît au début, à la fin ou au milieu du texte de la chaîne de recherche dans la PathToMatch propriété. Par exemple, pour rechercher tous les chemins qui commencent par « ~/vdir », la PathToMatch propriété est définie sur « ~/vdir% ».

De même, une recherche générique sur un nom d’utilisateur partiel peut faire apparaître le caractère générique à n’importe quel point de la chaîne de texte de la UsernameToMatch propriété. Par exemple, pour rechercher tous les noms d’utilisateur qui commencent par « John », la UsernameToMatch propriété ressemblerait à « John% ».

À l’aide du fournisseur de personnalisation par défaut, les PersonalizationStateInfoobjets dérivés sont retournés dans l’ordre alphabétique et triés par une combinaison de chemin d’accès et de nom d’utilisateur dans l’ordre croissant. L’ordre des objets de la collection est déterminé par le fournisseur.

Si userInactiveSinceDate est MaxValue, les valeurs retournées par cette méthode sont équivalentes à FindUserState.

usernameToMatch Et pathToMatch peuvent être null. Le usernameToMatch paramètre peut inclure des virgules (,), car certains magasins de données, tels que ceux exécutant Microsoft SQL Server, autorisent les virgules en tant que caractères génériques.

Voir aussi

• WebPartPersonalization
• contrôles de composants WebPart ASP.NET
• Vue d’ensemble de la personnalisation des composants WebPart
• Procédure pas à pas : Implémentation de la personnalisation des composants WebPart avec un contrôle utilisateur
• Personnalisation des composants WebPart

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

Paramètres

Retours

PersonalizationStateInfoCollection qui contient les informations d'état de personnalisation par utilisateur.

Exceptions

Remarques

Cette méthode retourne une collection d’instances, des informations d’état de UserPersonalizationStateInfo personnalisation par utilisateur où la valeur du pathToMatch paramètre correspond au chemin d’accès d’une page, usernameToMatch correspond à un nom d’utilisateur qui a des données de personnalisation associées à cette page et les utilisateurs sont considérés comme inactifs. En d’autres termes, pour chaque enregistrement retourné, la valeur de propriété de LastActivityDate l’utilisateur est inférieure ou égale à userInactiveSinceDate. La collection contient uniquement UserPersonalizationStateInfo des instances.

Cette méthode transmet des caractères génériques de paramètre au fournisseur de personnalisation sous-jacent. La façon dont le magasin de données gère ces caractères dépend donc de la façon dont le fournisseur gère des caractères tels qu’un astérisque (*), un symbole de pourcentage (%) ou un trait de soulignement (_).

Normalement, pour les magasins de données compatibles SQL, vous pouvez effectuer une recherche générique sur un chemin d’accès partiel avec le caractère générique qui apparaît au début, à la fin ou au milieu du texte de la chaîne de recherche dans la PathToMatch propriété. Par exemple, pour rechercher tous les chemins qui commencent par « ~/vdir », la PathToMatch propriété est définie sur « ~/vdir% ».

De même, une recherche générique sur un nom d’utilisateur partiel peut faire apparaître le caractère générique à n’importe quel point de la chaîne de texte de la UsernameToMatch propriété. Par exemple, pour rechercher tous les noms d’utilisateur qui commencent par « John », la UsernameToMatch propriété ressemblerait à « John% ».

À l’aide du fournisseur de personnalisation par défaut, les PersonalizationStateInfoobjets dérivés sont retournés dans l’ordre alphabétique et triés par une combinaison de chemin d’accès et de nom d’utilisateur dans l’ordre croissant. L’ordre des objets de la collection est déterminé par le fournisseur.

Si userInactiveSinceDate est MaxValue, les valeurs retournées par cette méthode sont équivalentes à FindUserState.

usernameToMatch Et pathToMatch peuvent être null. Le usernameToMatch paramètre peut avoir des virgules (,), car certains magasins de données, tels que ceux exécutant Microsoft SQL Server, autorisent les virgules en tant que caractères génériques.

Les données retournées sont limitées par pageIndex et , où pageIndex contrôle les enregistrements à retourner et pageSize contrôle le nombre d’enregistrements pageSizeà retourner. Par exemple, si pageIndex a été défini sur 0 et pageSize a été défini sur 25, les données retournées sont les 25 premières entrées. Si pageIndex a la valeur 1 et pageSize a la valeur 25, les données retournées sont les entrées 26 à 50. Le totalRecords paramètre retourne le nombre total d’enregistrements disponibles.

Voir aussi

• WebPartPersonalization
• contrôles de composants WebPart ASP.NET
• Vue d’ensemble de la personnalisation des composants WebPart
• Procédure pas à pas : Implémentation de la personnalisation des composants WebPart avec un contrôle utilisateur
• Personnalisation des composants WebPart