CreatingCookieEventArgs.CustomCredential Propriedade

Definição

Espaço de Nomes:
System.Web.ApplicationServices
Assemblagem:
System.Web.Extensions.dll

Obtém valores adicionais de autenticação fornecidos pelo utilizador.

public:
 property System::String ^ CustomCredential { System::String ^ get(); };
public string CustomCredential { get; }
member this.CustomCredential : string
Public ReadOnly Property CustomCredential As String

Valor de Propriedade

String

Os valores personalizados necessários para autenticação, para além do nome de utilizador e palavra-passe.

Exemplos

O exemplo seguinte mostra um gestor de eventos para o CreatingCookie evento. O handler recupera valores de utilizador do CreatingCookieEventArgs objeto para personalizar o cookie de autenticação. O valor transmitido na CustomCredential propriedade é armazenado na UserData propriedade do ticket de autenticação dos formulários.

Note

Armazene a CustomCredential propriedade num cookie apenas quando souber que os dados na propriedade não são sensíveis. Utilizadores maliciosos podem aceder aos valores do 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

Observações

Usas a CustomCredential propriedade para recuperar valores personalizados no ticket de autenticação. A CustomCredential propriedade contém o valor passado ao Login método. Normalmente, esta propriedade é usada para passar valores personalizados que devem ser validados com o nome de utilizador e a palavra-passe, como um número de identificação. Se mais do que um valor estiver armazenado na propriedade, deve analisar a CustomCredential propriedade para obter valores.

Aplica-se a