CacheDependency CacheDependency CacheDependency CacheDependency Class

Определение

Устанавливает отношения зависимости между элементом, который хранится в объекте приложения ASP.NET Cache, и файлом, ключом кэша, массивом или другим объектом CacheDependency.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. Класс CacheDependency отслеживает отношения зависимости на предмет изменений, автоматически удаляя кэшированный элемент.The CacheDependency class monitors the dependency relationships so that when any of them changes, the cached item will be automatically removed.

public ref class CacheDependency : IDisposable
public class CacheDependency : IDisposable
type CacheDependency = class
    interface IDisposable
Public Class CacheDependency
Implements IDisposable
Наследование
CacheDependencyCacheDependencyCacheDependencyCacheDependency
Производный
Реализации

Примеры

В следующем примере кода показано использование HasChanged свойства для определения того, CacheDependency был ли изменен с момента предыдущего запроса элемента в Cache.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. Значение, передаваемое start в параметре, задается равным DateTime.Now. dtThe dt value passed in the start parameter is set to DateTime.Now.

// 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.");
' 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 

Комментарии

При добавлении в кэш элемента, который зависит от другого объекта, например файла или массива файлов, зависимый элемент автоматически удаляется из кэша при изменении объекта.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. Например, предположим, что создается DataSet объект на основе данных в XML-файле.For example, suppose you create a DataSet object based on data in an XML file. Можно добавить DataSet в кэш CacheDependency с помощью объекта, который DataSet зависит от XML-файла.You can add the DataSet to the cache with a CacheDependency object that makes the DataSet dependent on the XML file. Если XML-файл изменяется, DataSet удаляется из кэша.If the XML file changes, the DataSet is removed from the cache.

Элементы с зависимостями можно добавлять в кэш приложения с Add помощью методов и. Cache.InsertYou can add items with dependencies to your application's cache with the Add and Cache.Insert methods. Нельзя использовать Item[String] свойство для добавления элементов в кэш с зависимостями.You cannot use the Item[String] property to add items to the cache with dependencies.

Чтобы настроить зависимость, необходимо создать экземпляр CacheDependency класса, указав файлы, ключи или каталоги, от которых зависит элемент, а затем передать зависимость Add методу или Cache.Insert .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. Экземпляр может представлять один файл или каталог, массив файлов или каталогов, а также массив файлов или папок вместе с набором ключей кэша (они представляют другие элементы, Cache хранящиеся в объекте). CacheDependencyThe 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).

Конструкторы

CacheDependency() CacheDependency() CacheDependency() CacheDependency()

Инициализирует новый экземпляр класса CacheDependency.Initializes a new instance of the CacheDependency class.

CacheDependency(String) CacheDependency(String) CacheDependency(String) CacheDependency(String)

Инициализирует новый экземпляр класса CacheDependency, отслеживающий изменения файла или каталога.Initializes a new instance of the CacheDependency class that monitors a file or directory for changes.

CacheDependency(String, DateTime) CacheDependency(String, DateTime) CacheDependency(String, DateTime) CacheDependency(String, DateTime)

Инициализирует новый экземпляр класса CacheDependency, отслеживающий изменения файла или каталога.Initializes a new instance of the CacheDependency class that monitors a file or directory for changes.

CacheDependency(String[]) CacheDependency(String[]) CacheDependency(String[]) CacheDependency(String[])

Инициализирует новый экземпляр класса CacheDependency, отслеживающий изменения массива путей (к файлам или каталогам).Initializes a new instance of the CacheDependency class that monitors an array of paths (to files or directories) for changes.

CacheDependency(String[], DateTime) CacheDependency(String[], DateTime) CacheDependency(String[], DateTime) CacheDependency(String[], DateTime)

Инициализирует новый экземпляр класса CacheDependency, отслеживающий изменения массива путей (к файлам или каталогам) и определяющий время начала отслеживания изменений.Initializes a new instance of the CacheDependency class that monitors an array of paths (to files or directories) for changes and specifies a time when change monitoring begins.

CacheDependency(String[], String[]) CacheDependency(String[], String[]) CacheDependency(String[], String[]) CacheDependency(String[], String[])

Инициализирует новый экземпляр класса CacheDependency, отслеживающий изменения массива путей (к файлам или каталогам), массива ключей кэша, или обоих сразу.Initializes a new instance of the CacheDependency class that monitors an array of paths (to files or directories), an array of cache keys, or both for changes.

CacheDependency(String[], String[], CacheDependency) CacheDependency(String[], String[], CacheDependency) CacheDependency(String[], String[], CacheDependency) CacheDependency(String[], String[], CacheDependency)

Инициализирует новый экземпляр класса CacheDependency, отслеживающий изменения массива путей (к файлам или каталогам), массива ключей кэша, или обоих сразу.Initializes a new instance of the CacheDependency class that monitors an array of paths (to files or directories), an array of cache keys, or both for changes. Он также становится зависимым от отдельного экземпляра класса CacheDependency.It also makes itself dependent upon a separate instance of the CacheDependency class.

CacheDependency(String[], String[], CacheDependency, DateTime) CacheDependency(String[], String[], CacheDependency, DateTime) CacheDependency(String[], String[], CacheDependency, DateTime) CacheDependency(String[], String[], CacheDependency, DateTime)

Инициализирует новый экземпляр класса CacheDependency, отслеживающий изменения массива путей (к файлам или каталогам), массива ключей кэша, или обоих сразу.Initializes a new instance of the CacheDependency class that monitors an array of paths (to files or directories), an array of cache keys, or both for changes. Он также становится зависимым от другого экземпляра класса CacheDependency и времени начала отслеживания изменений.It also makes itself dependent upon another instance of the CacheDependency class and a time when the change monitoring begins.

CacheDependency(String[], String[], DateTime) CacheDependency(String[], String[], DateTime) CacheDependency(String[], String[], DateTime) CacheDependency(String[], String[], DateTime)

Инициализирует новый экземпляр класса CacheDependency, отслеживающий изменения массива путей (к файлам или каталогам), массива ключей кэша, или обоих сразу.Initializes a new instance of the CacheDependency class that monitors an array of paths (to files or directories), an array of cache keys, or both for changes.

Свойства

HasChanged HasChanged HasChanged HasChanged

Получает значение, указывающее, изменился ли объект CacheDependency.Gets a value indicating whether the CacheDependency object has changed.

UtcLastModified UtcLastModified UtcLastModified UtcLastModified

Получает время последнего изменения зависимости.Gets the time when the dependency was last changed.

Методы

DependencyDispose() DependencyDispose() DependencyDispose() DependencyDispose()

Освобождает ресурсы, используемые классом CacheDependency и любыми классами, производными от CacheDependency.Releases the resources used by the CacheDependency class and any classes that derive from CacheDependency.

Dispose() Dispose() Dispose() Dispose()

Освобождает ресурсы, используемые объектом CacheDependency.Releases the resources used by the CacheDependency object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FinishInit() FinishInit() FinishInit() FinishInit()

Завершает инициализацию объекта CacheDependency.Completes initialization of the CacheDependency object.

GetFileDependencies() GetFileDependencies() GetFileDependencies() GetFileDependencies()

Возвращает зависимости файлов.Gets the file dependencies.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetUniqueID() GetUniqueID() GetUniqueID() GetUniqueID()

Возвращает уникальный идентификатор для объекта CacheDependency .Retrieves a unique identifier for a CacheDependency object.

ItemRemoved() ItemRemoved() ItemRemoved() ItemRemoved()

Вызывается при удалении отслеживаемой записи кэша.Called when a monitored cache entry is removed.

KeepDependenciesAlive() KeepDependenciesAlive() KeepDependenciesAlive() KeepDependenciesAlive()

Обновляет время последнего обращения к каждому элементу кэша, который зависит от этого элемента.Updates the last access time of every cache item that depends on this item.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
NotifyDependencyChanged(Object, EventArgs) NotifyDependencyChanged(Object, EventArgs) NotifyDependencyChanged(Object, EventArgs) NotifyDependencyChanged(Object, EventArgs)

Уведомляет базовый объект CacheDependency об изменении зависимости, представленной производным классом CacheDependency.Notifies the base CacheDependency object that the dependency represented by a derived CacheDependency class has changed.

SetCacheDependencyChanged(Action<Object,EventArgs>) SetCacheDependencyChanged(Action<Object,EventArgs>) SetCacheDependencyChanged(Action<Object,EventArgs>) SetCacheDependencyChanged(Action<Object,EventArgs>)

Добавляет метод действия для обработки уведомления заинтересованной стороны об изменениях в этой зависимости.Adds an Action method to handle notifying interested party in changes to this dependency.

SetUtcLastModified(DateTime) SetUtcLastModified(DateTime) SetUtcLastModified(DateTime) SetUtcLastModified(DateTime)

Помечает время последнего изменения зависимости.Marks the time when a dependency last changed.

TakeOwnership() TakeOwnership() TakeOwnership() TakeOwnership()

Позволяет первому пользователю объявлять монопольный доступ к этой зависимости.Allows the first user to declare exclusive ownership of this dependency.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Применяется к

Дополнительно