System.Web 2.0.0.0 System.Configuration.ConfigurationElement

The class provides a way to programmatically access and modify the add element of the outputCacheProfiles section in the caching section of a configuration file.

The object centralizes frequently used configuration settings such as dependencies, cache location, and cache expiration time, eliminating the need to specify them on every page.

The can be applied to a page using the CacheProfile attribute of the @ OutputCache directive.

The @ OutputCache directive can override all the settings contained by an object except for the attribute. This is to enable or disable the without having to modify the directives in all the pages that might have overridden it.

The class monitors the dependencies so that when any cached item changes, the cached item will be automatically removed.

Configures the output cache profile that can be used by the application pages. This class cannot be inherited.

- Constructor
  To be added.

  Initializes a new instance of the class.

  The name value to use.
  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("duration", DefaultValue="-1")
  System.Int32 To be added.

  The represents the time in seconds that the page or user control is cached. Setting this property establishes an expiration policy for HTTP responses from the page or control to which it applies and will automatically cause the caching of their output.

  The must be defined in either the profile or the @ OutputCache directive of a page using the profile.

  Gets or sets the time duration during which the page or control is cached.

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

  The property allows enabling or disabling the caching mechanism in one place only. It affects all the pages or controls that use this .

  Gets or sets a value indicating whether caching is enabled.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("location")
  System.Web.UI.OutputCacheLocation To be added.

  If is set to Any, the output cache can be located on the browser client, where the request originated; on a proxy server, or any other server, participating in the request; or on the server where the request was processed.

  Gets or sets the output cache location.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("name", DefaultValue="", Options=System.Configuration.ConfigurationPropertyOptions.IsRequired | System.Configuration.ConfigurationPropertyOptions.IsKey)
  System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))
  System.Configuration.StringValidator(MinLength=1)
  System.String To be added.

  You use the to assign a value to the CacheProfile attribute of the @ OutputCache directive if you want to apply the values to a page or control.

  Gets or sets the name.

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

  The page that has the property set to true issues a response specifying in its header to prevent secondary storage of sensitive information.

  Setting this attribute to true is equivalent to invoking the method during a Web request.

  Gets or sets a value indicating whether secondary storage is enabled.

  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("sqlDependency")
  System.String To be added.

  The defines a relationship between a Web application and an instance of SQL Server, allowing the detection of changes in the data at the server. The ensures that output cached pages are removed from the cache whenever the SQL table on which they depend changes.

  The class monitors the table so that when the table changes, the item will be automatically removed from the Cache. This class cannot be inherited.

  Gets or sets the property.

  2.0.0.0
- Property
  2.0.0.0
  System.Configuration.ConfigurationProperty("varyByContentEncoding")
  System.String To be added.

  The settings are the same ones used by the VaryByContentEncoding attribute of the @ OutputCache directive.

  is introduced in the .NET Framework version 3.5. For more information, see The .NET Framework 3.5 Architecture.

  Gets or sets the semicolon-delimited set of content encodings to be cached.

- Property
  System.Configuration.ConfigurationProperty("varyByControl")
  System.String To be added.

  The is a semicolon-delimited set of IDs of controls to be cached.

  For more information, see Caching Multiple Versions of User Control Output.

  The settings are the same ones used by the VaryByControls attribute of the @ OutputCache directive.

  Gets or sets the property.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("varyByCustom")
  System.String To be added.

  The can be any text that represents custom output-caching requirements. If a custom string is entered, you must override the method in the application's Global.asax file.

  The settings are the same ones used by the VaryByCustom attribute of the @ OutputCache directive.

  Gets or sets the property.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("varyByHeader")
  System.String To be added.

  The is a semicolon-delimited set of headers used to vary the cached output. These are HTTP headers associated with the request. For more information, see Caching Multiple Versions of a Page.

  The settings are the same ones used by the VaryByHeader attribute of the @ OutputCache. Varying by all headers by setting the value of "*" is not recommended. It can result in cache overflow or a denial of service attack on the Web server.

  Gets or sets the property.

  2.0.0.0
- Property
  System.Configuration.ConfigurationProperty("varyByParam")
  System.String To be added.

  The is a semicolon-delimited set of parameters used to vary the cached output. It allows varying the cached output by GET query string or form POST parameters. For instance, you can vary the user-control output to the cache by specifying the user-control name along with either a query string or a form POST parameter. For more information, see Caching Multiple Versions of User Control Output.

  The setting must be defined in either the profile or the @ OutputCache directive of the page using the profile.

  The settings are the same ones used by the VaryByParam attribute of the @ OutputCache. Varying by all parameters by setting the value of "*" is not recommended. It can result in cache overflow or a denial of service attack on the Web server.

  Gets or sets the property.

  2.0.0.0