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
)
public void Add (
	CacheDependency[] dependencies
)
public function Add (
	... dependencies : CacheDependency[]
)
Not applicable.

Parameters

dependencies

The array of CacheDependency objects to add.

Exception typeCondition

ArgumentNullException

dependencies is a null reference (Nothing in Visual Basic).

- or -

A CacheDependency object in dependencies is a null reference (Nothing in Visual Basic).

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 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show: