System.Web 2.0.0.0 System.Configuration.ConfigurationElement

The class provides a way to programmatically access and modify the forms element of a configuration authentication section.

This type is part of a group that includes the ,the , and the types. The types other than the collection type directly affect the underlying configuration tags.

The can write information into the related section of the configuration file according to the restrictions defined by the section property whose value is . Any attempt to write in a configuration file at a level not allowed in the hierarchy will result in an error message generated by the parser. However, you can use this class to read configuration information at any level in the hierarchy. For safety and scalability, it is recommended that you use an external repository, such as a database, to keep the users' credentials.

Configures an ASP.NET application to use the forms modality.

- Constructor
  To be added.

  Initializes a new instance of the class.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("cookieless", DefaultValue="UseDeviceProfile")
  System.Web.HttpCookieMode To be added.

  The property defines whether forms-based authentication should use a cookie to exchange user information.

  Gets or sets a value indicating whether forms-based authentication should use cookies.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("credentials")
  System.Web.Configuration.FormsAuthenticationCredentials To be added.

  The property gets the user names and passwords to use during forms-based authentication.

  When security is required, you should use alternative ways of storing the user names and passwords; for example, in a database store. If you decide to use this collection, you should use the provided encryption facility.

  Gets the collection of user names and passwords.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("defaultUrl", DefaultValue="default.aspx")
  System.Configuration.StringValidator(MinLength=1)
  System.String To be added.

  The is used if the user accesses the login page directly or if a return URL is not provided.

  Gets or sets the default URL.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("domain", DefaultValue="")
  System.String To be added.

  The is used for the authentication cookies.

  This property corresponds to the value of .

  This setting will take precedence over the domain attribute of the httpCookies section for forms authentication cookies.

  Gets or sets the domain name to be sent with forms authentication cookies.

  2.0.0.0
- Property
  System.Configuration.ConfigurationElementProperty To be added. To be added. To be added. 2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("enableCrossAppRedirects", DefaultValue="False")
  System.Boolean To be added.

  The property value sets the enableCrossAppRedirects attribute of the forms section in the authentication section of a configuration.

  The property is checked by the method when the redirection is to a URL that is not in the current application. If is true, then the redirect is performed; otherwise the browser is redirected to the page defined in the property.

  When performing redirects across applications, you must ensure that several of the attributes in the form configuration section are duplicated across the authenticated applications. For more information and an example, see Forms Authentication Across Applications.

  Gets or sets a value indicating whether authenticated users can be redirected to URLS in other applications.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("loginUrl", DefaultValue="login.aspx")
  System.Configuration.StringValidator(MinLength=1)
  System.String To be added.

  The property specifies the redirection URL for the request when the user is not authenticated or when no valid authentication cookie exists.

  Gets or sets the redirection URL for the request.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("name", DefaultValue=".ASPXAUTH")
  System.Configuration.StringValidator(MinLength=1)
  System.String To be added. To be added.

  Gets or sets the cookie name.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("path", DefaultValue="/")
  System.Configuration.StringValidator(MinLength=1)
  System.String To be added.

  The property indicates where the authentication cookie resides and is transmitted along with the authentication cookie itself.

  Gets or sets the cookie path.

  2.0.0.0
- Property
  System.Configuration.ConfigurationPropertyCollection To be added. To be added. To be added. 2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("protection", DefaultValue="All")
  System.Web.Configuration.FormsProtectionEnum To be added. To be added.

  Gets or sets the encryption type used to encrypt the cookie.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("requireSSL", DefaultValue="False")
  System.Boolean To be added.

  If is true, a Web application rejects all the forms authentication requests that do not use an SSL connection.

  Gets or sets a value indicating whether a Secure Sockets Layer (SSL) connection is required when transmitting authentication information.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("slidingExpiration", DefaultValue="True")
  System.Boolean To be added.

  When the is set to true, the time interval during which the authentication cookie is valid is reset to the expiration property value. This happens if the user browses after half of the timeout has expired. For example, if you set an expiration of 20 minutes by using sliding expiration, a user can visit the site at 2:00 PM and receive a cookie that is set to expire at 2:20 PM. The expiration is only updated if the user visits the site after 2:10 PM. If the user visits the site at 2:09 PM, the cookie is not updated because half of the expiration time has not passed. If the user then waits 12 minutes, visiting the site at 2:21 PM, the cookie will be expired.

  Gets or sets the authentication sliding expiration.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("timeout", DefaultValue="00:30:00")
  System.Configuration.TimeSpanValidator(MinValueString="00:01:00")
  System.ComponentModel.TypeConverter(typeof(System.Configuration.TimeSpanMinutesConverter))
  System.TimeSpan To be added. To be added.

  Gets or sets the authentication time-out.

  2.0.0.0