CreatingCookieEventArgs CreatingCookieEventArgs CreatingCookieEventArgs CreatingCookieEventArgs Class

Определение

Предоставляет данные для события CreatingCookie.Provides data for the CreatingCookie event.

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

Примеры

В примере показан обработчик событий для CreatingCookie событий.The following example shows an event handler for the CreatingCookie event. Обработчик извлекает значения пользователя из CreatingCookieEventArgs объект настроить файл cookie проверки подлинности.The handler retrieves user values from the CreatingCookieEventArgs object to customize the authentication cookie. Обработчик сохраняет значение из CustomCredential свойство в билет проверки подлинности и задает CookieIsSet свойства true для указания, что был создан файл cookie проверки подлинности.The handler saves the value from the CustomCredential property in the authentication ticket and sets the CookieIsSet property to true to indicate that the authentication cookie has been created.

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 обработчик событий.The CreatingCookieEventArgs class supplies values to any CreatingCookie event handler. С помощью свойств этого класса можно получить учетные данные пользователя при создании пользовательской проверки подлинности файла cookie.By using the properties of this class, you can retrieve user credentials when you create a custom authentication cookie.

AuthenticationService Формируемых классом CreatingCookie событие, когда он задает файл cookie проверки подлинности, после прошли проверку подлинности учетных данных пользователя.The AuthenticationService class raises the CreatingCookie event when it sets the authentication cookie, after the user credentials have been authenticated. AuthenticationService Класса конструкции CreatingCookieEventArgs и передает его в любую CreatingCookie обработчик событий.The AuthenticationService class constructs a CreatingCookieEventArgs object and passes it to any CreatingCookie event handler.

Получить учетные данные пользователя через UserName Password, и CustomCredential свойства.You retrieve the user credentials through the UserNamePassword, and CustomCredential properties. CustomCredential Свойство может содержать любые пользовательские значения, которые необходимы для проверки подлинности, такие как идентификатор.The CustomCredential property can contain any custom values that you need in order to authenticate, such as an identification number. IsPersistent Свойство указывает, сохраняются ли файл cookie проверки подлинности за пределами текущего сеанса.The IsPersistent property indicates whether the authentication cookie should be retained past the current session. Задайте CookieIsSet свойства true при создании файла cookie проверки подлинности, таким образом, чтобы AuthenticationService класса не создает файл cookie.Set the CookieIsSet property to true if you create the authentication cookie, so that the AuthenticationService class does not create the cookie.

Свойства

CookieIsSet CookieIsSet CookieIsSet CookieIsSet

Возвращает или задает значение, позволяющее определить, был ли создан файл Cookie для проверки подлинности.Gets or sets a value that indicates whether the authentication cookie has been created.

CustomCredential CustomCredential CustomCredential CustomCredential

Возвращает дополнительные значения проверки подлинности, которые были указаны пользователем.Gets additional authentication values that are provided by the user.

IsPersistent IsPersistent IsPersistent IsPersistent

Возвращает значение, позволяет определить, нужно ли сохранять файл Cookie для проверки подлинности после завершения текущего сеанса.Gets a value that indicates whether the authentication cookie should be retained beyond the current session.

Password Password Password Password

Возвращает пароль пользователя.Gets the password for the user.

UserName UserName UserName UserName

Получает имя для пользователя.Gets the name for the user.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

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

Дополнительно