PartialCachingAttribute Constructor (Int32, String, String, String)
Initializes a new instance of the PartialCachingAttribute class, specifying the caching duration, any GET and POST values, control names, and custom output caching requirements used to vary the cache.
Assembly: System.Web (in System.Web.dll)
public PartialCachingAttribute( int duration, string varyByParams, string varyByControls, string varyByCustom )
Parameters
- duration
-
Type:
System.Int32
The amount of time, in seconds, that the user control is cached.
- varyByParams
-
Type:
System.String
A semicolon-separated list of strings used to vary the output cache. By default, these strings correspond to a query string value sent with GET method attributes or to a parameter sent using the POST method. When this attribute is set to multiple parameters, the output cache contains a different version of the requested document for each specified parameter. Possible values include "none", "*", and any valid query string or POST parameter name.
- varyByControls
-
Type:
System.String
A semicolon-separated list of strings used to vary the output cache. These strings represent fully qualified names of properties on a user control. When this parameter is used for a user control, the user control output is varied to the cache for each specified user control property.
- varyByCustom
-
Type:
System.String
Any text that represents custom output caching requirements. If this parameter is given a value of "browser", the cache is varied by browser name and major version information. If a custom string is entered, you must override the HttpApplication.GetVaryByCustomString method in your application's Global.asax file.
The following code example demonstrates how the PartialCachingAttribute(Int32, String, String, String) constructor can be applied to a user control. In the example, the constructor is used to indicate that the user control can be cached, specify the caching duration as 20 seconds, and specify a control named state for which the user control output will be varied.
// Set the PartialCachingAttribute.Duration property to // 20 seconds and the PartialCachingAttribute.VaryByControls // property to the ID of the server control to vary the output by. // In this case, it is state, the ID assigned to a DropDownList // server control. [PartialCaching(20, null, "state", null)]
Available since 1.1