CreatingCookieEventArgs.CustomCredential Właściwość

Definicja

Przestrzeń nazw:

System.Web.ApplicationServices

Zestaw:

System.Web.Extensions.dll

Pobiera dodatkowe wartości uwierzytelniania udostępniane przez użytkownika.

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

public string CustomCredential { get; }

member this.CustomCredential : string

Public ReadOnly Property CustomCredential As String

Wartość właściwości

String

Wartości niestandardowe wymagane do uwierzytelniania, inne niż nazwa użytkownika i hasło.

Przykłady

W poniższym przykładzie przedstawiono procedurę obsługi zdarzeń dla CreatingCookie zdarzenia. Program obsługi pobiera wartości użytkownika z CreatingCookieEventArgs obiektu w celu dostosowania pliku cookie uwierzytelniania. Wartość przekazana we CustomCredential właściwości jest przechowywana we UserData właściwości biletu uwierzytelniania formularzy.

Uwaga

CustomCredential Zapisz właściwość w pliku cookie tylko wtedy, gdy wiadomo, że dane w właściwości nie są poufne. Złośliwi użytkownicy mogą uzyskiwać dostęp do wartości w pliku 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

Uwagi

Właściwość służy do pobierania CustomCredential wartości niestandardowych w bilecie uwierzytelniania. Właściwość CustomCredential zawiera wartość przekazaną Login do metody. Zazwyczaj ta właściwość służy do przekazywania niestandardowych wartości, które muszą zostać zweryfikowane przy użyciu nazwy użytkownika i hasła, na przykład numeru identyfikacyjnego. Jeśli w właściwości jest przechowywanych więcej niż jedna wartość, należy przeanalizować CustomCredential właściwość w celu pobrania wartości.