CreatingCookieEventArgs Класс

Определение

Предоставляет данные о событии CreatingCookie.

public ref class CreatingCookieEventArgs : EventArgs
public class CreatingCookieEventArgs : EventArgs
type CreatingCookieEventArgs = class
    inherit EventArgs
Public Class CreatingCookieEventArgs
Inherits EventArgs
Наследование
CreatingCookieEventArgs

Примеры

В следующем примере показан обработчик событий для CreatingCookie события . Обработчик извлекает пользовательские значения из CreatingCookieEventArgs объекта для настройки файла cookie проверки подлинности. Обработчик сохраняет значение из свойства в запросе CustomCredential проверки подлинности и задает свойству CookieIsSettrue значение , чтобы указать, что файл 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

Комментарии

Класс CreatingCookieEventArgs предоставляет значения любому CreatingCookie обработчику событий. С помощью свойств этого класса можно получить учетные данные пользователя при создании пользовательского файла cookie проверки подлинности.

Класс AuthenticationService вызывает событие при CreatingCookie установке файла cookie проверки подлинности после проверки подлинности учетных данных пользователя. Класс AuthenticationService создает объект и передает его в любой CreatingCookieEventArgsCreatingCookie обработчик событий.

Учетные данные пользователя можно получить с помощью UserNamePasswordсвойств , и CustomCredential . Свойство CustomCredential может содержать любые пользовательские значения, необходимые для проверки подлинности, например идентификационный номер. Свойство IsPersistent указывает, должен ли файл cookie проверки подлинности храниться после текущего сеанса. CookieIsSet При создании файла cookie проверки подлинности задайте для свойства значение true , чтобы AuthenticationService класс не создавал файл cookie.

Свойства

CookieIsSet

Возвращает или задает значение, позволяющее определить, был ли создан файл Cookie для проверки подлинности.

CustomCredential

Возвращает дополнительные значения проверки подлинности, которые были указаны пользователем.

IsPersistent

Возвращает значение, позволяет определить, нужно ли сохранять файл Cookie для проверки подлинности после завершения текущего сеанса.

Password

Возвращает пароль пользователя.

UserName

Получает имя для пользователя.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

См. также раздел