This documentation is archived and is not being maintained.

PartialCachingAttribute.VaryByControls Property

Gets a list of user control properties that the output cache uses to vary the user control.

Namespace:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public string VaryByControls { get; set; }

Property Value

Type: System.String
The list of user control properties.

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, to specify the caching duration as 20 seconds, and to 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)]

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

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.