FormsAuthenticationTicket Class
Provides access to properties and values of the ticket used with forms authentication to identify users. This class cannot be inherited.
Assembly: System.Web (in System.Web.dll)
The FormsAuthenticationTicket type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | FormsAuthenticationTicket(String, Boolean, Int32) | Initializes a new instance of the FormsAuthenticationTicket class using a cookie name and expiration information. |
![]() | FormsAuthenticationTicket(Int32, String, DateTime, DateTime, Boolean, String) | Initializes a new instance of the FormsAuthenticationTicket class with cookie name, version, expiration date, issue date, persistence, and user-specific data. The cookie path is set to the default value established in the application's configuration file. |
![]() | FormsAuthenticationTicket(Int32, String, DateTime, DateTime, Boolean, String, String) | Initializes a new instance of the FormsAuthenticationTicket class with cookie name, version, directory path, issue date, expiration date, persistence, and user-defined data. |
| Name | Description | |
|---|---|---|
![]() | CookiePath | Gets the cookie path for the forms-authentication ticket. |
![]() | Expiration | Gets the local date and time at which the forms-authentication ticket expires. |
![]() | Expired | Gets a value indicating whether the forms-authentication ticket has expired. |
![]() | IsPersistent | Gets a value indicating whether the cookie that contains the forms-authentication ticket information is persistent. |
![]() | IssueDate | Gets the local date and time at which the forms-authentication ticket was originally issued. |
![]() | Name | Gets the user name associated with the forms-authentication ticket. |
![]() | UserData | Gets a user-specific string stored with the ticket. |
![]() | Version | Gets the version number of the ticket. |
| Name | Description | |
|---|---|---|
![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
The FormsAuthenticationTicket class is used to create an object that represents the authentication ticket that is used by forms authentication to identify an authenticated user. The properties and values of a forms-authentication ticket are converted to and from an encrypted string that is stored in a cookie or in the URL.
The FormsAuthentication class provides an Encrypt method to create a string value that can be stored in a cookie or in the URL from a FormsAuthenticationTicket. The FormsAuthentication class also provides a Decrypt method to create a FormsAuthenticationTicket object from the encrypted authentication ticket retrieved from the forms-authentication cookie or the URL.
The FormsAuthenticationTicket for the current authenticated user can be accessed using the Ticket property of the FormsIdentity class. You can access the current FormsIdentity object by casting the Identity property of the current User as type FormsIdentity.
The following code example stores the result of the Encrypt method in a cookie using the FormsCookieName and redirects the user to the URL returned from the GetRedirectUrl method.
Security Note |
|---|
This example contains a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview. |
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
