CreatingCookieEventArgs Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет данные о событии CreatingCookie.
public ref class CreatingCookieEventArgs : EventArgs
public class CreatingCookieEventArgs : EventArgs
type CreatingCookieEventArgs = class
inherit EventArgs
Public Class CreatingCookieEventArgs
Inherits EventArgs
- Наследование
Примеры
В следующем примере показан обработчик событий для 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) |