CacheDependency Classe

Definição

Estabelece uma relação de dependência entre um item armazenado no objeto Cache e um arquivo, chave de cache, uma matriz de ambos ou outro objeto CacheDependency do aplicativo ASP.NET.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. A classe CacheDependency monitora as relações de dependência para que quando alguma delas seja alterada, o item armazenado cache seja automaticamente removido.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 sealed : IDisposable
public ref class CacheDependency : IDisposable
public sealed class CacheDependency : IDisposable
public class CacheDependency : IDisposable
type CacheDependency = class
    interface IDisposable
Public NotInheritable Class CacheDependency
Implements IDisposable
Public Class CacheDependency
Implements IDisposable
Herança
CacheDependency
Derivado
Implementações

Exemplos

O exemplo de código a seguir demonstra como usar a propriedade HasChanged para determinar se um CacheDependency alterado desde a solicitação anterior de um item no 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. O valor de dt passado no parâmetro start é definido como DateTime.Now.The 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 

Comentários

Se você adicionar um item ao cache que seja dependente de outro objeto, como um arquivo ou uma matriz de arquivos, o item dependente será removido automaticamente do cache quando o objeto for alterado.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. Por exemplo, suponha que você crie um objeto DataSet com base em dados em um arquivo XML.For example, suppose you create a DataSet object based on data in an XML file. Você pode adicionar o DataSet ao cache com um objeto CacheDependency que torna o DataSet dependente do arquivo XML.You can add the DataSet to the cache with a CacheDependency object that makes the DataSet dependent on the XML file. Se o arquivo XML for alterado, o DataSet será removido do cache.If the XML file changes, the DataSet is removed from the cache.

Você pode adicionar itens com dependências ao cache do seu aplicativo com os métodos Add e Cache.Insert.You can add items with dependencies to your application's cache with the Add and Cache.Insert methods. Você não pode usar a propriedade Item[String] para adicionar itens ao cache com dependências.You cannot use the Item[String] property to add items to the cache with dependencies.

Para configurar uma dependência, você cria uma instância da classe CacheDependency, especificando os arquivos, as chaves ou os diretórios nos quais o item é dependente e, em seguida, passa a dependência para o método Add ou 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. A instância de CacheDependency pode representar um único arquivo ou diretório, uma matriz de arquivos ou diretórios ou uma matriz de arquivos ou diretórios, juntamente com uma matriz de chaves de cache (elas representam outros itens armazenados no objeto Cache).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).

Construtores

CacheDependency(String)

Inicializa uma nova instância da classe CacheDependency que monitora um arquivo ou diretório para alterações.Initializes a new instance of the CacheDependency class that monitors a file or directory for changes.

CacheDependency(String, DateTime)

Inicializa uma nova instância da classe CacheDependency que monitora um arquivo ou diretório para alterações.Initializes a new instance of the CacheDependency class that monitors a file or directory for changes.

CacheDependency(String[])

Inicializa uma nova instância da classe CacheDependency que monitora uma matriz de caminhos (para arquivos ou diretórios) quanto a alterações.Initializes a new instance of the CacheDependency class that monitors an array of paths (to files or directories) for changes.

CacheDependency(String[], DateTime)

Inicializa uma nova instância da classe CacheDependency que monitora uma matriz de caminhos (para arquivos ou diretórios) quanto a alterações e especifica uma hora em que o monitoramento de alterações começa.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[])

Inicializa uma nova instância da classe CacheDependency que monitora uma matriz de caminhos (para arquivos ou diretórios), uma matriz de chaves de cache ou ambas quanto a alterações.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)

Inicializa uma nova instância da classe CacheDependency que monitora uma matriz de caminhos (para arquivos ou diretórios), uma matriz de chaves de cache ou ambas quanto a alterações.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. Também se torna dependente de uma instância separada da classe CacheDependency.It also makes itself dependent upon a separate instance of the CacheDependency class.

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

Inicializa uma nova instância da classe CacheDependency que monitora uma matriz de caminhos (para arquivos ou diretórios), uma matriz de chaves de cache ou ambas quanto a alterações.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. Também se torna dependente de outra instância da classe CacheDependency e da hora em que o monitoramento de alterações começa.It also makes itself dependent upon another instance of the CacheDependency class and a time when the change monitoring begins.

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

Inicializa uma nova instância da classe CacheDependency que monitora uma matriz de caminhos (para arquivos ou diretórios), uma matriz de chaves de cache ou ambas quanto a alterações.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.

Propriedades

HasChanged

Obtém um valor que indica se o objeto CacheDependency foi alterado.Gets a value indicating whether the CacheDependency object has changed.

UtcLastModified

Obtém a hora em que a dependência foi alterada pela última vez.Gets the time when the dependency was last changed.

Métodos

Dispose()

Libera os recursos usados pelo objeto CacheDependency.Releases the resources used by the CacheDependency object.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetFileDependencies()

Obtém as dependências de arquivo.Gets the file dependencies.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetUniqueID()

Recupera um identificador exclusivo de um objeto CacheDependency.Retrieves a unique identifier for a CacheDependency object.

ItemRemoved()

Chamado quando uma entrada de cache monitorado é removida.Called when a monitored cache entry is removed.

KeepDependenciesAlive()

Atualiza a hora do último acesso de cada item de cache que depende desse item.Updates the last access time of every cache item that depends on this item.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

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

Adiciona um método de Ação para tratar da notificação de terceiros interessados nas alterações nessa dependência.Adds an Action method to handle notifying interested party in changes to this dependency.

TakeOwnership()

Permite que o primeiro usuário declare a propriedade exclusiva desta dependência.Allows the first user to declare exclusive ownership of this dependency.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a

Veja também