This documentation is archived and is not being maintained.

AggregateCacheDependency::Add Method

Adds an array of CacheDependency objects to the AggregateCacheDependency object.

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

public:
void Add(
	... array<CacheDependency^>^ dependencies
)

Parameters

dependencies
Type: array<System.Web.Caching::CacheDependency>

The array of CacheDependency objects to add.

ExceptionCondition
ArgumentNullException

dependencies is nullptr.

- or -

A CacheDependency object in dependencies is nullptr.

InvalidOperationException

A CacheDependency object is referenced from more than one Cache entry.

The following code example uses the Add method in conjunction with the AggregateCacheDependency constructor to create two CacheDependency objects, add them to a CacheDependency array named myDepArray, and then make the item in the cache dependent on those two CacheDependency objects.

' Create two CacheDependency objects, one to a 
' text file and the other to an XML file.  
' Create a CacheDependency array with these  
' two objects as items in the array.
 txtDep = New CacheDependency(Server.MapPath("Storage.txt"))
 xmlDep = New CacheDependency(Server.MapPath("authors.xml"))
 Dim DepArray() As CacheDependency = {txtDep, xmlDep}

 ' Create an AggregateCacheDependency object and  
 ' use the Add method to add the array to it.   
 aggDep = New AggregateCacheDependency()
 aggDep.Add(DepArray)

 ' Call the GetUniqueId method to generate 
 ' an ID for each dependency in the array.
 msg1.Text = aggDep.GetUniqueId()

 ' Add the new data set to the cache with  
 ' dependencies on both files in the array.
 Cache.Insert("XMLDataSet", Source, aggDep)

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: