Partage via

PersonalizationAdministration.FindInactiveUserState Méthode

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Retourne une collection d’informations d’état de personnalisation par utilisateur pour les utilisateurs inactifs, en fonction des paramètres spécifiés.

Surcharges

Nom Description
FindInactiveUserState(String, String, DateTime)

Retourne une collection d’informations d’état de personnalisation par utilisateur pour les utilisateurs inactifs, en fonction des paramètres spécifiés.
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

Retourne une collection d’informations d’état de personnalisation par utilisateur pour les utilisateurs inactifs, en fonction des paramètres spécifiés.

FindInactiveUserState(String, String, DateTime)

Retourne une collection d’informations d’état de personnalisation par utilisateur pour les utilisateurs inactifs, en fonction des paramètres spécifiés.

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

pathToMatch
String

Chemin d’accès de la page à mettre en correspondance.

usernameToMatch
String

Nom d’utilisateur à mettre en correspondance avec les données de personnalisation associées à la page.

userInactiveSinceDate
DateTime

La dernière date à laquelle les informations de personnalisation d’un utilisateur ont été consultées.

Retours

PersonalizationStateInfoCollection

Qui PersonalizationStateInfoCollection contient des informations d’état de personnalisation par utilisateur.

Exceptions

ArgumentException

pathToMatch ou usernameToMatch avant ou après le découpage est une chaîne vide («  »).

- ou -

Le fournisseur d’un fournisseur de personnalisation défini dans la configuration n’est pas du type correct.

- ou -

La longueur de la chaîne d’un paramètre est supérieure à 256 caractères.

ConfigurationErrorsException

Une exception de configuration s’est produite lors de la tentative de création et d’initialisation d’une instance de l’un des fournisseurs de personnalisation configurés.

- ou -

Le fournisseur de personnalisation par défaut défini dans la configuration est introuvable.

Remarques

Cette méthode retourne une collection d’instances, d’informations d’état de 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 dont les données de UserPersonalizationStateInfo personnalisation sont 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 les caractères tels qu’un astérisque (*), un symbole de pourcentage (%) ou un trait de soulignement (_).

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

De même, une recherche de caractères génériques sur un nom d’utilisateur partiel peut avoir le caractère générique apparaître à n’importe quel point dans la chaîne de texte de la UsernameToMatch propriété. Par exemple, pour rechercher tous les noms d’utilisateur commençant 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 par 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 c’est MaxValuele cas, les valeurs retournées de cette méthode sont équivalentes à FindUserState.

Les deux pathToMatch et usernameToMatch 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

S’applique à

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

Retourne une collection d’informations d’état de personnalisation par utilisateur pour les utilisateurs inactifs, en fonction des paramètres spécifiés.

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

pathToMatch
String

Chemin d’accès de la page à mettre en correspondance.

usernameToMatch
String

Nom d’utilisateur à mettre en correspondance avec les données de personnalisation associées à la page.

userInactiveSinceDate
DateTime

Les informations de personnalisation de la dernière date ont été consultées.

pageIndex
Int32

Index de base zéro de la page des résultats à retourner.

pageSize
Int32

Nombre d’enregistrements à retourner.

totalRecords
Int32

Nombre total d’enregistrements disponibles.

Retours

PersonalizationStateInfoCollection

Qui PersonalizationStateInfoCollection contient des informations d’état de personnalisation par utilisateur.

Exceptions

ArgumentException

pathToMatch ou usernameToMatch avant ou après le découpage est une chaîne vide («  »).

- ou -

pageIndex est inférieur à zéro

- ou -

pageSize est inférieur ou égal à zéro.

- ou -

la combinaison d’Int32.MaxValuepageIndexpageSize et la dépasse.

- ou -

Le fournisseur d’un fournisseur de personnalisation défini dans la configuration n’est pas du type correct.

- ou -

La longueur de la chaîne d’un paramètre est supérieure à 256 caractères.

ConfigurationErrorsException

Une exception de configuration s’est produite lors de la tentative de création et d’initialisation d’une instance de l’un des fournisseurs de personnalisation configurés.

- ou -

Le fournisseur de personnalisation par défaut défini dans la configuration est introuvable.

Remarques

Cette méthode retourne une collection d’instances, d’informations d’état de 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 dont les données de UserPersonalizationStateInfo personnalisation sont 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 de la façon dont le fournisseur gère les caractères tels qu’un astérisque (*), un symbole de pourcentage (%) ou un trait de soulignement (_).

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

De même, une recherche de caractères génériques sur un nom d’utilisateur partiel peut avoir le caractère générique apparaître à n’importe quel point dans la chaîne de texte de la UsernameToMatch propriété. Par exemple, pour rechercher tous les noms d’utilisateur commençant 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 par 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 c’est MaxValuele cas, les valeurs retournées de cette méthode sont équivalentes à FindUserState.

Les deux pathToMatch et usernameToMatch 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 comme caractères génériques.

Les données retournées sont limitées pageIndex par et pageSize, où pageIndex les contrôles des enregistrements à renvoyer et pageSize contrôlent le nombre d’enregistrements à retourner. Par exemple, si pageIndex elle a été définie sur 0 et pageSize a été définie sur 25, les données retournées sont les 25 premières entrées. Si pageIndex elle a été définie sur 1 et pageSize a été définie sur 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

S’applique à