CacheDependency Classe

Referência

Definição

Namespace:: System.Web.Caching

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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. A classe CacheDependency monitora as relações de dependência para que quando alguma delas seja alterada, o item armazenado cache seja automaticamente removido.

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: Object
CacheDependency

Derivado: System.Web.Caching.AggregateCacheDependency

System.Web.Caching.SqlCacheDependency

Implementações: IDisposable

Exemplos

O exemplo de código a Cacheseguir demonstra o uso da HasChanged propriedade para determinar se uma CacheDependency alteração desde a solicitação anterior para um item no . O dt valor passado no start parâmetro é definido como 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 depende de outro objeto, como um arquivo ou uma matriz de arquivos, o item dependente será removido automaticamente do cache quando o objeto for alterado. Por exemplo, suponha que você crie um DataSet objeto com base em dados em um arquivo XML. Você pode adicionar o DataSet cache com um CacheDependency objeto que torna o DataSet dependente do arquivo XML. Se o arquivo XML for alterado, ele DataSet será removido do cache.

Você pode adicionar itens com dependências ao cache do aplicativo com os métodos e Cache.Insert os Add métodos. Você não pode usar a Item[] propriedade para adicionar itens ao cache com dependências.

Para configurar uma dependência, você cria uma instância da CacheDependency classe, especificando os arquivos, chaves ou diretórios nos quais o item é dependente e, em seguida, passa a dependência para o método ou Cache.Insert o Add método. A CacheDependency instância 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 (eles representam outros itens armazenados no Cache objeto).

Construtores

CacheDependency()	Inicializa uma nova instância da classe CacheDependency.
CacheDependency(String)	Inicializa uma nova instância da classe CacheDependency que monitora um arquivo ou diretório para alterações.
CacheDependency(String, DateTime)	Inicializa uma nova instância da classe CacheDependency que monitora um arquivo ou diretório para alterações.
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.
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.
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.
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. Também se torna dependente de uma instância separada da classe CacheDependency.
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. Também se torna dependente de outra instância da classe CacheDependency e da hora em que o monitoramento de alterações começa.
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.

Propriedades

HasChanged	Obtém um valor que indica se o objeto CacheDependency foi alterado.
UtcLastModified	Obtém a hora em que a dependência foi alterada pela última vez.

Métodos

DependencyDispose()	Libera os recursos usados pela classe CacheDependency e pelas classes que derivam de CacheDependency.
Dispose()	Libera os recursos usados pelo objeto CacheDependency.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FinishInit()	Conclui a inicialização do objeto CacheDependency.
GetFileDependencies()	Obtém as dependências de arquivo.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueID()	Recupera um identificador exclusivo de um objeto CacheDependency.
ItemRemoved()	Chamado quando uma entrada de cache monitorado é removida.
KeepDependenciesAlive()	Atualiza a hora do último acesso de cada item de cache que depende desse item.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
NotifyDependencyChanged(Object, EventArgs)	Notifica o objeto CacheDependency de base de que a dependência representada por uma classe CacheDependency derivada foi alterada.
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.
SetUtcLastModified(DateTime)	Marca a hora em que a dependência foi alterada pela última vez.
TakeOwnership()	Permite que o primeiro usuário declare a propriedade exclusiva desta dependência.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a