CacheDependency Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Estabelece uma relação de dependência entre um item armazenado no objeto Cache de uma aplicação ASP.NET e um ficheiro, chave de cache, um array de qualquer um ou outro objeto CacheDependency. A CacheDependency classe monitoriza as relações de dependência para que, quando alguma delas mude, o item em 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
-
CacheDependency
- Derivado
- Implementações
Exemplos
O exemplo de código seguinte demonstra o uso da HasChanged propriedade para determinar se mudou CacheDependency desde o pedido anterior para um item no Cache. 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
Observações
Se adicionar um elemento à cache que depende de outro objeto, como um ficheiro ou array de ficheiros, o item dependente é automaticamente removido da cache quando o objeto muda. Por exemplo, suponha que cria um DataSet objeto baseado em dados num ficheiro XML. Podes adicionar o DataSet à cache com um CacheDependency objeto que torna o DataSet dependente do ficheiro XML. Se o ficheiro XML mudar, ele DataSet é removido da cache.
Podes adicionar itens com dependências à cache da tua aplicação com os Add métodos and Cache.Insert . Não podes usar a Item[] propriedade para adicionar itens à cache com dependências.
Para configurar uma dependência, cria-se uma instância da CacheDependency classe, especificando os ficheiros, chaves ou diretórios dos quais o item depende, e depois passa a dependência para o Add método ou Cache.Insert . A CacheDependency instância pode representar um único ficheiro ou diretório, um array de ficheiros ou diretórios, ou um array de ficheiros ou diretórios juntamente com um array de chaves de cache (estas representam outros itens armazenados no Cache objeto).
Construtores
| Name | Description |
|---|---|
| CacheDependency() |
Inicializa uma nova instância da CacheDependency classe. |
| CacheDependency(String, DateTime) |
Inicializa uma nova instância da CacheDependency classe que monitoriza um ficheiro ou diretório para alterações. |
| CacheDependency(String) |
Inicializa uma nova instância da CacheDependency classe que monitoriza um ficheiro ou diretório para alterações. |
| CacheDependency(String[], DateTime) |
Inicializa uma nova instância da CacheDependency classe que monitoriza um array de caminhos (para ficheiros ou diretórios) à procura de alterações e especifica o momento em que começa a monitorização de alterações. |
| CacheDependency(String[], String[], CacheDependency, DateTime) |
Inicializa uma nova instância da CacheDependency classe que monitoriza um array de caminhos (para ficheiros ou diretórios), um array de chaves de cache, ou ambos para alterações. Também se torna dependente de outra instância da CacheDependency classe e de um momento em que a monitorização da mudança começa. |
| CacheDependency(String[], String[], CacheDependency) |
Inicializa uma nova instância da CacheDependency classe que monitoriza um array de caminhos (para ficheiros ou diretórios), um array de chaves de cache, ou ambos para alterações. Também se torna dependente de uma instância separada da CacheDependency classe. |
| CacheDependency(String[], String[], DateTime) |
Inicializa uma nova instância da CacheDependency classe que monitoriza um array de caminhos (para ficheiros ou diretórios), um array de chaves de cache, ou ambos para alterações. |
| CacheDependency(String[], String[]) |
Inicializa uma nova instância da CacheDependency classe que monitoriza um array de caminhos (para ficheiros ou diretórios), um array de chaves de cache, ou ambos para alterações. |
| CacheDependency(String[]) |
Inicializa uma nova instância da CacheDependency classe que monitoriza um array de caminhos (para ficheiros ou diretórios) à procura de alterações. |
Propriedades
| Name | Description |
|---|---|
| HasChanged |
Recebe um valor que indica se o CacheDependency objeto mudou. |
| UtcLastModified |
Obtém a hora em que a dependência foi alterada pela última vez. |
Métodos
| Name | Description |
|---|---|
| DependencyDispose() |
Liberta os recursos usados pela CacheDependency classe e quaisquer classes que derivem de CacheDependency. |
| Dispose() |
Liberta os recursos usados pelo CacheDependency objeto. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FinishInit() |
Completa a inicialização do CacheDependency objeto. |
| GetFileDependencies() |
Obtém as dependências dos ficheiros. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUniqueID() |
Recupera um identificador único para um CacheDependency objeto. |
| ItemRemoved() |
Chamada quando uma entrada de cache monitorizada é removida. |
| KeepDependenciesAlive() |
Atualiza o último tempo de acesso de cada item de cache que depende desse item. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| NotifyDependencyChanged(Object, EventArgs) |
Notifica o objeto base CacheDependency que a dependência representada por uma classe derivada CacheDependency mudou. |
| SetCacheDependencyChanged(Action<Object,EventArgs>) |
Adiciona um método Action para lidar com a notificação das partes interessadas sobre alterações a esta dependência. |
| SetUtcLastModified(DateTime) |
Marca o momento em que uma dependência mudou pela última vez. |
| TakeOwnership() |
Permite ao primeiro utilizador declarar a propriedade exclusiva desta dependência. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |