AuthenticatingEventArgs Classe

Definição

Fornece dados para o evento de Authenticating .

public ref class AuthenticatingEventArgs : EventArgs
public class AuthenticatingEventArgs : EventArgs
type AuthenticatingEventArgs = class
    inherit EventArgs
Public Class AuthenticatingEventArgs
Inherits EventArgs
Herança
AuthenticatingEventArgs

Exemplos

O exemplo a seguir mostra um manipulador de eventos que passa os UserName valores e Password para um provedor de associação personalizado para validar as credenciais do usuário. O manipulador de eventos define Authenticated como o valor retornado do ValidateUser método e define AuthenticationIsComplete como para true que a AuthenticationService classe não valide as credenciais.

void AuthenticationService_Authenticating(object sender, System.Web.ApplicationServices.AuthenticatingEventArgs e)
{
    if (e.UserName.IndexOf("@contoso.com") >= 0)
    {
        e.Authenticated = Membership.Providers["ContosoSqlProvider"].ValidateUser(e.UserName, e.Password);
    }
    else if (e.UserName.IndexOf("@fabrikam.com") >= 0)
    {
        e.Authenticated = Membership.Providers["FabrikamSqlProvider"].ValidateUser(e.UserName, e.Password);
    }
    else
    {
        e.Authenticated = Membership.Provider.ValidateUser(e.UserName, e.Password);
    }
    e.AuthenticationIsComplete = true;
}
Sub AuthenticationService_Authenticating _
   (ByVal sender As Object, _
    ByVal e As System.Web.ApplicationServices.AuthenticatingEventArgs)
    
    If (e.Username.IndexOf("@contoso.com") >= 0) Then
        e.Authenticated = Membership.Providers("ContosoSqlProvider").ValidateUser(e.Username, e.Password)
    ElseIf (e.Username.IndexOf("@fabrikam.com") >= 0) Then
        e.Authenticated = Membership.Providers("FabrikamSqlProvider").ValidateUser(e.Username, e.Password)
    Else
        e.Authenticated = Membership.Provider.ValidateUser(e.Username, e.Password)
    End If
    e.AuthenticationIsComplete = True
End Sub

Comentários

Você cria um manipulador para o Authenticating evento quando deseja personalizar como as credenciais do usuário são autenticadas em tempo de execução. A AuthenticatingEventArgs classe fornece valores para qualquer Authenticating manipulador de eventos. Usando as propriedades disponíveis nessa classe, você pode recuperar as credenciais do usuário para personalizar a autenticação.

A AuthenticationService classe aciona o Authenticating evento antes de validar as credenciais do usuário. A AuthenticationService classe constrói uma instância do objeto e a AuthenticatingEventArgs passa para qualquer Authenticating manipulador de eventos.

Você pode usar as UserNamepropriedades e CustomCredentialPassword para recuperar as credenciais do usuário. A CustomCredential propriedade pode conter valores adicionais necessários para autenticação, como um número de identificação.

A Authenticated propriedade indica se as credenciais do usuário são válidas. Você define a Authenticated propriedade como o resultado de sua autenticação personalizada. Além disso, você definirá a AuthenticationIsComplete propriedade como true se tiver verificado as credenciais do usuário e não quiser que a classe verifique as credenciais do AuthenticationService usuário por meio do provedor de associação padrão.

Propriedades

Authenticated

Obtém ou define um valor que indica se as credenciais do usuário são válidas.

AuthenticationIsComplete

Obtém ou define um valor que indica se as credenciais do usuário foram autenticadas.

CustomCredential

Obtém valores de usuário adicionais para autenticação.

Password

Obtém a senha do usuário.

UserName

Obtém o nome de autenticação para o usuário.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também