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 свойства в билете проверки подлинности и задает CookieIsSet свойство, чтобы true указать, что файл 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 создает CreatingCookieEventArgs объект и передает его любому CreatingCookie обработчику событий.
Вы извлекаете учетные данные пользователя с помощью UserNamePasswordсвойств и CustomCredential свойств. Свойство CustomCredential может содержать любые пользовательские значения, необходимые для проверки подлинности, например идентификационный номер. Свойство IsPersistent указывает, должен ли файл cookie проверки подлинности храниться в текущем сеансе. Задайте для свойства значениеtrue, если вы создаете CookieIsSet файл cookie проверки подлинности, чтобы AuthenticationService класс не создавал файл cookie.
Свойства
| Имя | Описание |
|---|---|
| CookieIsSet |
Возвращает или задает значение, указывающее, был ли создан файл cookie проверки подлинности. |
| CustomCredential |
Возвращает дополнительные значения проверки подлинности, предоставляемые пользователем. |
| IsPersistent |
Возвращает значение, указывающее, должен ли файл cookie проверки подлинности храниться за пределами текущего сеанса. |
| Password |
Возвращает пароль для пользователя. |
| UserName |
Возвращает имя пользователя. |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |