CreatingCookieEventArgs.CustomCredential Propriété

Définition

Espace de noms:

System.Web.ApplicationServices

Assembly:

System.Web.Extensions.dll

Obtient des valeurs d'authentification supplémentaires qui sont fournies par l'utilisateur.

public:
 property System::String ^ CustomCredential { System::String ^ get(); };

public string CustomCredential { get; }

member this.CustomCredential : string

Public ReadOnly Property CustomCredential As String

Valeur de propriété

String

Les valeurs personnalisées requises pour l'authentification, autre que le nom d'utilisateur et le mot de passe.

Exemples

L’exemple suivant montre un gestionnaire d’événements pour l’événement CreatingCookie . Le gestionnaire récupère les valeurs utilisateur de l’objet CreatingCookieEventArgs afin de personnaliser le cookie d’authentification. La valeur transmise dans la CustomCredential propriété est stockée dans la UserData propriété du ticket d’authentification par formulaire.

Notes

Stockez la CustomCredential propriété dans un cookie uniquement lorsque vous savez que les données contenues dans la propriété ne sont pas sensibles. Les utilisateurs malveillants peuvent accéder aux valeurs du cookie.

void AuthenticationService_CreatingCookie(object sender, 
    System.Web.ApplicationServices.CreatingCookieEventArgs e)
{
    FormsAuthenticationTicket ticket = new
          FormsAuthenticationTicket
            (1,
             e.UserName,
             DateTime.Now,
             DateTime.Now.AddMinutes(30),
             e.IsPersistent,
             e.CustomCredential,
             FormsAuthentication.FormsCookiePath);

    string encryptedTicket =
         FormsAuthentication.Encrypt(ticket);

    HttpCookie cookie = new HttpCookie
         (FormsAuthentication.FormsCookieName,
          encryptedTicket);
    cookie.Expires = DateTime.Now.AddMinutes(30);

    HttpContext.Current.Response.Cookies.Add(cookie);
    e.CookieIsSet = true;
}

Sub AuthenticationService_CreatingCookie(ByVal sender As Object, _
                 ByVal e As System.Web.ApplicationServices.CreatingCookieEventArgs)
    Dim ticket As FormsAuthenticationTicket = New _
       FormsAuthenticationTicket _
        (1, _
         e.Username, _
         DateTime.Now, _
         DateTime.Now.AddMinutes(30), _
         e.IsPersistent, _
         e.CustomCredential, _
         FormsAuthentication.FormsCookiePath)
        
    Dim encryptedTicket As String = FormsAuthentication.Encrypt(ticket)
    
    Dim cookie As HttpCookie = New _
        HttpCookie(FormsAuthentication.FormsCookieName, encryptedTicket)
    cookie.Expires = DateTime.Now.AddMinutes(30)
    
    HttpContext.Current.Response.Cookies.Add(cookie)
    e.CookieIsSet = True
End Sub

Remarques

Vous utilisez la CustomCredential propriété pour récupérer des valeurs personnalisées dans le ticket d’authentification. La CustomCredential propriété contient la valeur passée à la Login méthode . En règle générale, cette propriété est utilisée pour passer des valeurs personnalisées qui doivent être validées avec le nom d’utilisateur et le mot de passe, comme un numéro d’identification. Si plusieurs valeurs sont stockées dans la propriété, vous devez analyser la CustomCredential propriété pour récupérer des valeurs.