ProfileProvider.FindInactiveProfilesByUserName, méthode

La méthode FindInactiveProfilesByUserName est utilisée pour récupérer des informations de profil pour les profils utilisateur inutilisés dans lesquels le nom d'utilisateur correspond au paramètre usernameToMatch fourni. Seules les données pour le applicationName spécifié dans le fichier de configuration sont retournées. Le paramètre authenticationOption spécifie les types de profils à rechercher : les profils anonymes, les profils authentifiés ou tous les profils. Parmi les profils recherchés, tout profil avec un LastActivityDate qui se produit quand la valeur du paramètre userInactiveSinceDate spécifié est retournée ou avant qu'elle ne le soit.

Si votre source de données prend en charge des fonctions de recherche supplémentaires, par exemple les caractères génériques, vous pouvez fournir des fonctions de recherche plus étendues pour les noms d'utilisateurs.

Les résultats retournés par FindInactiveProfilesByUserName sont limités par les paramètres pageIndex et pageSize. Le paramètre pageSize identifie le nombre maximal d'objets ProfileInfo à retourner dans ProfileInfoCollection. Le paramètre pageIndex identifie la page de résultats à retourner, 0 correspondant à la première page. Le paramètre totalRecords est un paramètre out dont la valeur est égale au nombre total de profils utilisateur inactifs pour le applicationName configuré, en fonction des paramètres authenticationOption et userInactiveSinceDate. Par exemple, s'il y a treize utilisateurs pour l'application applicationName configurée et que la valeur de pageIndex est 1 avec pageSize égal à 5, la collection ProfileInfoCollection retournée contiendra les profils inactifs numérotés de six à dix. Le paramètre totalRecords aura la valeur 13.

L'exemple de code suivant montre la signature de méthode d'une implémentation de la méthode FindInactiveProfilesByUserName. Pour obtenir un exemple complet d'implémentation ProfileProvider, consultez Sample Profile Provider Implementation.

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

	return new ProfileInfoCollection();
}

.NET Framework

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources