AuthenticatingEventArgs Classe

Definizione

Fornisce i dati per l'evento Authenticating.

public ref class AuthenticatingEventArgs : EventArgs
public class AuthenticatingEventArgs : EventArgs
type AuthenticatingEventArgs = class
    inherit EventArgs
Public Class AuthenticatingEventArgs
Inherits EventArgs
Ereditarietà
AuthenticatingEventArgs

Esempio

Nell'esempio seguente viene illustrato un gestore eventi che passa i UserName valori e Password a un provider di appartenenze personalizzato per convalidare le credenziali utente. Il gestore eventi imposta Authenticated sul valore restituito del ValidateUser metodo e imposta AuthenticationIsComplete su true in modo che la AuthenticationService classe non convalida le credenziali.

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

Commenti

Si crea un gestore per l'evento Authenticating quando si vuole personalizzare la modalità di autenticazione delle credenziali dell'utente in fase di esecuzione. La AuthenticatingEventArgs classe fornisce valori a qualsiasi Authenticating gestore eventi. Usando le proprietà disponibili in questa classe, è possibile recuperare le credenziali utente per personalizzare l'autenticazione.

La AuthenticationService classe genera l'evento Authenticating prima di convalidare le credenziali utente. La AuthenticationService classe costruisce un'istanza dell'oggetto AuthenticatingEventArgs e la passa a qualsiasi Authenticating gestore eventi.

È possibile usare le UserNameproprietà , Password e CustomCredential per recuperare le credenziali utente. La CustomCredential proprietà può contenere valori aggiuntivi necessari per l'autenticazione, ad esempio un numero di identificazione.

La Authenticated proprietà indica se le credenziali utente sono valide. La proprietà viene Authenticated impostata sul risultato dell'autenticazione personalizzata. Inoltre, si imposta la AuthenticationIsComplete proprietà su true se sono state controllate le credenziali utente e non si vuole che la AuthenticationService classe controlli le credenziali utente tramite il provider di appartenenze predefinito.

Proprietà

Authenticated

Ottiene o imposta un valore che indica se le credenziali utente sono valide.

AuthenticationIsComplete

Ottiene o imposta un valore che indica se le credenziali utente sono state autenticate.

CustomCredential

Ottiene valori dell'utente aggiuntivi per l'autenticazione.

Password

Ottiene la password per l'utente.

UserName

Ottiene il nome autenticazione per l'utente.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche