ProfileManager.FindProfilesByUserName Method (ProfileAuthenticationOption, String)

Retrieves all profile information for profiles in which the user name matches the specified name.

Namespace: System.Web.Profile
Assembly: System.Web (in system.web.dll)

public:
static ProfileInfoCollection^ FindProfilesByUserName (
	ProfileAuthenticationOption authenticationOption, 
	String^ usernameToMatch
)
public static ProfileInfoCollection FindProfilesByUserName (
	ProfileAuthenticationOption authenticationOption, 
	String usernameToMatch
)
public static function FindProfilesByUserName (
	authenticationOption : ProfileAuthenticationOption, 
	usernameToMatch : String
) : ProfileInfoCollection
Not applicable.

Parameters

authenticationOption

One of the ProfileAuthenticationOption enumeration values, specifying whether anonymous, authenticated, or both types of profiles are returned.

usernameToMatch

The user name for which to search.

Return Value

A ProfileInfoCollection containing user profile information for profiles where the user name matches the supplied usernameToMatch parameter.

Exception typeCondition

ArgumentNullException

usernameToMatch is a null reference (Nothing in Visual Basic).

ArgumentException

usernameToMatch is an empty string ("").

The FindProfilesByUserName method returns a list of all profile information for which the user name matches the supplied usernameToMatch parameter value for the configured ApplicationName property value. Use the authenticationOption parameter to specify whether you want only anonymous profiles, only authenticated profiles, or all profiles to be searched.

You can retrieve profile information for user profiles in pages of data using the overload for the FindProfilesByUserName method that takes additional pageIndex and pageSize parameters.

Note that your profile provider may support wildcard characters in the usernameToMatch parameter. For example, the FindProfilesByUserName method of the SqlProfileProvider class supports wildcard characters in the usernameToMatch parameter.

The FindProfilesByUserName method calls the FindProfilesByUserName method of the default profile provider. The default profile provider is specified using the defaultProvider attribute of the profile configuration element. If the user profile contains properties that are managed by a profile provider other than the default provider, the data source for the other profile provider is not searched. To find profiles that are managed by a profile provider other than the default provider, obtain a reference to the profile provider using the Providers property and call the FindProfilesByUserName method of the provider directly.

The following code example allows a user to supply a usernameToMatch value and a ProfileAuthenticationOption enumeration value and retrieves profile information for any matching profiles. The example allows the user to specify whether to return inactive profiles exclusively. If the user specifies only inactive profiles, the FindInactiveProfilesByUserName method is called; otherwise, the FindProfilesByUserName method is called.

Security noteSecurity Note:

This example contains a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview (Visual Studio).

No code example is currently available or this language may not be supported.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: