ProfileProvider.FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32) Método

Definição

Quando substituído em uma classe derivada, recupera informações de perfil para perfis em que o nome de usuário corresponde aos nomes de usuário especificados.When overridden in a derived class, retrieves profile information for profiles in which the user name matches the specified user names.

public:
 abstract System::Web::Profile::ProfileInfoCollection ^ FindProfilesByUserName(System::Web::Profile::ProfileAuthenticationOption authenticationOption, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.Profile.ProfileInfoCollection FindProfilesByUserName (System.Web.Profile.ProfileAuthenticationOption authenticationOption, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
abstract member FindProfilesByUserName : System.Web.Profile.ProfileAuthenticationOption * string * int * int * int -> System.Web.Profile.ProfileInfoCollection
Public MustOverride Function FindProfilesByUserName (authenticationOption As ProfileAuthenticationOption, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As ProfileInfoCollection

Parâmetros

authenticationOption
ProfileAuthenticationOption

Um dos valores de ProfileAuthenticationOption, especificando se anônimo, autenticado ou ambos os tipos de perfis são retornados.One of the ProfileAuthenticationOption values, specifying whether anonymous, authenticated, or both types of profiles are returned.

usernameToMatch
String

O nome de usuário a ser pesquisado.The user name to search for.

pageIndex
Int32

O índice da página de resultados a serem retornados.The index of the page of results to return.

pageSize
Int32

O tamanho da página de resultados a ser retornada.The size of the page of results to return.

totalRecords
Int32

Quando este método retorna, contém o número total de perfis.When this method returns, contains the total number of profiles.

Retornos

ProfileInfoCollection

Um ProfileInfoCollection que contém informações de perfil de usuário para perfis em que o nome de usuário corresponde ao parâmetro usernameToMatch fornecido.A ProfileInfoCollection containing user-profile information for profiles where the user name matches the supplied usernameToMatch parameter.

Exemplos

O exemplo de código a seguir mostra a assinatura do método para uma implementação do FindProfilesByUserName método.The following code example shows the method signature for an implementation of the FindProfilesByUserName method. Para obter um exemplo de uma ProfileProvider implementação completa, consulte como compilar e executar o exemplo de provedor de perfil.For an example of a full ProfileProvider implementation, see How to: Build and Run the Profile Provider Example.

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

    return new ProfileInfoCollection();
}
Public Overrides Function FindProfilesByUserName( _
ByVal authenticationOption As ProfileAuthenticationOption, _
ByVal usernameToMatch As String, _
ByVal pageIndex As Integer, _
ByVal pageSize As Integer, _
 ByRef totalRecords As Integer) As ProfileInfoCollection

  totalRecords = 0

  Return New ProfileInfoCollection()
End Function

Comentários

O FindProfilesByUserName método retorna uma lista de informações de perfil para perfis nos quais o nome de usuário corresponde ao usernameToMatch parâmetro fornecido.The FindProfilesByUserName method returns a list of profile information for profiles in which the user name matches the supplied usernameToMatch parameter. Somente os dados para o applicationName especificado no arquivo de configuração são retornados.Only data for the applicationName specified in the configuration file is returned. O authenticationOption parâmetro especifica se somente perfis anônimos, somente perfis autenticados ou todos os perfis são pesquisados.The authenticationOption parameter specifies whether only anonymous profiles, only authenticated profiles, or all profiles are searched.

Se sua fonte de dados oferecer suporte a recursos de pesquisa adicionais, como caracteres curinga, você poderá fornecer recursos de pesquisa mais extensivos para nomes de usuário.If your data source supports additional search capabilities, such as wildcard characters, you can provide more extensive search capabilities for user names.

Os resultados retornados por FindProfilesByUserName são restritos pelos pageIndex pageSize parâmetros e.The results returned by FindProfilesByUserName are constrained by the pageIndex and pageSize parameters. O pageSize parâmetro identifica o número máximo de ProfileInfo objetos a serem retornados no ProfileInfoCollection .The pageSize parameter identifies the maximum number of ProfileInfo objects to return in the ProfileInfoCollection. O pageIndex parâmetro identifica qual página de resultados retornar, onde zero identifica a primeira página.The pageIndex parameter identifies which page of results to return, where zero identifies the first page. O totalRecords parâmetro é um out parâmetro que é definido como o número total de perfis de usuário inativos para o configurado applicationName , com base nos authenticationOption userInactiveSinceDate parâmetros e.The totalRecords parameter is an out parameter that is set to the total number of inactive user profiles for the configured applicationName, based on the authenticationOption and userInactiveSinceDate parameters. Por exemplo, se houver 13 usuários para o configurado applicationName , e o pageIndex valor for 1 com um pageSize de 5, o ProfileInfoCollection retornado conterá o sexto por meio dos décimos perfis inativos retornados.For example, if there are 13 users for the configured applicationName, and the pageIndex value is 1 with a pageSize of 5, the ProfileInfoCollection returned would contain the sixth through the tenth inactive profiles returned. O totalRecords parâmetro seria definido como 13.The totalRecords parameter would be set to 13.

Aplica-se a