AuthenticatingEventArgs Classe

Definizione

Spazio dei nomi:

System.Web.ApplicationServices

Assembly:

System.Web.Extensions.dll

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à

Object

EventArgs

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)

Vedi anche

• Panoramica del servizio di autenticazione di Windows Communication Foundation