ProfileProvider.FindInactiveProfilesByUserName Méthode

Référence

Définition

Espace de noms:: System.Web.Profile

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

En cas de substitution dans une classe dérivée, récupère des informations de profil pour les profils dans lesquels la dernière date d'activité s'est produite à ou avant la date spécifiée et le nom d'utilisateur correspond au nom d'utilisateur spécifié.

public:
 abstract System::Web::Profile::ProfileInfoCollection ^ FindInactiveProfilesByUserName(System::Web::Profile::ProfileAuthenticationOption authenticationOption, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.Profile.ProfileInfoCollection FindInactiveProfilesByUserName (System.Web.Profile.ProfileAuthenticationOption authenticationOption, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);

abstract member FindInactiveProfilesByUserName : System.Web.Profile.ProfileAuthenticationOption * string * DateTime * int * int * int -> System.Web.Profile.ProfileInfoCollection

Public MustOverride Function FindInactiveProfilesByUserName (authenticationOption As ProfileAuthenticationOption, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As ProfileInfoCollection

Paramètres

authenticationOption: ProfileAuthenticationOption

Une des valeurs ProfileAuthenticationOption spécifiant si le type de profil anonyme, authentifié, ou les deux sont retournés.

usernameToMatch: String

Nom d'utilisateur à rechercher.

userInactiveSinceDate: DateTime

DateTime qui identifie quels profils utilisateur sont considérés inactifs. Si la valeur LastActivityDate d'un profil utilisateur survient à ou avant cette date et cette heure, le profil est considéré comme inactif.

pageIndex: Int32

Index de la page de résultats à retourner.

pageSize: Int32

Taille de la page de résultats à retourner.

totalRecords: Int32

Lorsque cette méthode est retournée, contient le nombre total de profils.

Retours

ProfileInfoCollection

ProfileInfoCollection contenant les informations sur les profils utilisateur pour les profils inactifs où le nom d'utilisateur correspond au paramètre usernameToMatch fourni.

Exemples

L’exemple de code suivant montre la signature de méthode pour une implémentation de la FindInactiveProfilesByUserName méthode . Pour obtenir un exemple d’implémentation complète ProfileProvider , consultez Guide pratique pour générer et exécuter l’exemple de fournisseur de profils.

public override ProfileInfoCollection FindInactiveProfilesByUserName(
    ProfileAuthenticationOption authenticationOption,
    string usernameToMatch,
    DateTime userInactiveSinceDate,
    int pageIndex,
    int pageSize,
    out int totalRecords)
{
    totalRecords = 0;

    return new ProfileInfoCollection();
}

Public Overrides Function FindInactiveProfilesByUserName( _
ByVal authenticationOption As ProfileAuthenticationOption, _
ByVal usernameToMatch As String, _
ByVal userInactiveSinceDate As DateTime, _
ByVal pageIndex As Integer, _
ByVal pageSize As Integer, _
 ByRef totalRecords As Integer) As ProfileInfoCollection

  totalRecords = 0

  Return New ProfileInfoCollection()
End Function

Remarques

La FindInactiveProfilesByUserName méthode est utilisée pour récupérer les informations de profil des profils utilisateur inutilisés pour les profils dans lesquels le nom d’utilisateur correspond au paramètre fourni usernameToMatch . Seules les données pour le applicationName spécifié dans le fichier de configuration sont retournées. Le authenticationOption paramètre spécifie si seuls les profils anonymes, seuls les profils authentifiés ou tous les profils font l’objet d’une recherche. Parmi les profils recherchés, tout profil avec un LastActivityDate qui se produit sur ou avant la valeur de paramètre spécifiée userInactiveSinceDate est retourné.

Si votre source de données prend en charge des fonctionnalités de recherche supplémentaires, telles que des caractères génériques, vous pouvez fournir des fonctionnalités de recherche plus étendues pour les noms d’utilisateur.

Les résultats retournés par FindInactiveProfilesByUserName sont limités par les pageIndex paramètres et pageSize . Le pageSize paramètre identifie le nombre maximal d’objets ProfileInfo à retourner dans le ProfileInfoCollection. Le pageIndex paramètre identifie la page de résultats à retourner, où zéro identifie la première page. Le totalRecords paramètre est un out paramètre qui est défini sur le nombre total de profils utilisateur inactifs pour le configuré applicationName, en fonction des authenticationOption paramètres et userInactiveSinceDate . Par exemple, s’il y a 13 utilisateurs pour le configuré applicationNameet que la pageIndex valeur est 1 avec un pageSize de 5, le ProfileInfoCollection retourné contient le sixième au dixième profils inactifs retournés. Le totalRecords paramètre est défini sur 13.

S’applique à