Establishes a dependency relationship between an item stored in an ASP.NET application's Cache object and a file, cache key, an array of either, or another CacheDependency object. The CacheDependency class monitors the dependency relationships so that when any of them changes, the cached item will be automatically removed.
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _ <AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _ Public Class CacheDependency _ Implements IDisposable
Dim instance As CacheDependency
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)] [AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)] public class CacheDependency : IDisposable
[AspNetHostingPermissionAttribute(SecurityAction::InheritanceDemand, Level = AspNetHostingPermissionLevel::Minimal)] [AspNetHostingPermissionAttribute(SecurityAction::LinkDemand, Level = AspNetHostingPermissionLevel::Minimal)] public ref class CacheDependency : IDisposable
public class CacheDependency implements IDisposable
If you add an item to the cache that is dependent on another object, such as a file or array of files, the dependent item is automatically removed from the cache when the object changes. For example, suppose you create a DataSet object based on data in an XML file. You can add the DataSet to the cache with a CacheDependency object that makes the DataSet dependent on the XML file. If the XML file changes, the DataSet is removed from the cache.
You can add items with dependencies to your application's cache with the Add and Cache..::.Insert methods. You cannot use the Item property to add items to the cache with dependencies.
To set up a dependency, you create an instance of the CacheDependency class, specifying the files, keys, or directories on which the item is dependent, and then pass the dependency to the Add or Cache..::.Insert method. The CacheDependency instance can represent a single file or directory, an array of files or directories, or an array of files or directories along with an array of cache keys (these represent other items stored in the Cache object).
The following code example demonstrates using the HasChanged property to determine whether a CacheDependency changed since the previous request for an item in the Cache. The dt value passed in the start parameter is set to DateTime..::.Now.
' Insert the cache item. Dim dep As New CacheDependency(fileName, dt) myCache.Insert("key", "value", dep) ' Check whether CacheDependency.HasChanged is true. If dep.HasChanged Then Response.Write("<p>The dependency has changed.") Else Response.Write("<p>The dependency has not changed.") End If
// Insert the cache item. CacheDependency dep = new CacheDependency(fileName, dt); cache.Insert("key", "value", dep); // Check whether CacheDependency.HasChanged is true. if (dep.HasChanged) Response.Write("<p>The dependency has changed."); else Response.Write("<p>The dependency has not changed.");
for operating in a hosted environment. Demand value: LinkDemand; Permission value: Minimal.
for operating in a hosted environment. Demand value: InheritanceDemand; Permission value: Minimal.
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