CacheItemPolicy 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.
Representa um conjunto de detalhes de despejo e expiração para uma entrada específica do cache.
public ref class CacheItemPolicy
public class CacheItemPolicy
type CacheItemPolicy = class
Public Class CacheItemPolicy
- Herança
-
CacheItemPolicy
Exemplos
O exemplo seguinte mostra como criar um item de cache em memória que monitoriza o caminho de um ficheiro de texto. A cache cria um CacheItemPolicy objeto e define a AbsoluteExpiration propriedade para expulsar a cache após 60 segundos.
Protected Sub Button1_Click(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button1.Click
Dim cache As ObjectCache = MemoryCache.Default
Dim fileContents As String = TryCast(cache("filecontents"), _
String)
If fileContents Is Nothing Then
Dim policy As New CacheItemPolicy()
policy.AbsoluteExpiration = _
DateTimeOffset.Now.AddSeconds(60.0)
Dim filePaths As New List(Of String)()
Dim cachedFilePath As String = Server.MapPath("~") & _
"\cacheText.txt"
filePaths.Add(cachedFilePath)
policy.ChangeMonitors.Add(New _
HostFileChangeMonitor(filePaths))
' Fetch the file contents.
fileContents = File.ReadAllText(cachedFilePath)
cache.Set("filecontents", fileContents, policy)
End If
Label1.Text = fileContents
End Sub
protected void Button1_Click(object sender, EventArgs e)
{
ObjectCache cache = MemoryCache.Default;
string fileContents = cache["filecontents"] as string;
if (fileContents == null)
{
CacheItemPolicy policy = new CacheItemPolicy();
policy.AbsoluteExpiration =
DateTimeOffset.Now.AddSeconds(60.0);
List<string> filePaths = new List<string>();
string cachedFilePath = Server.MapPath("~") +
"\\cacheText.txt";
filePaths.Add(cachedFilePath);
policy.ChangeMonitors.Add(new
HostFileChangeMonitor(filePaths));
// Fetch the file contents.
fileContents = File.ReadAllText(cachedFilePath);
cache.Set("filecontents", fileContents, policy);
}
Label1.Text = fileContents;
}
Observações
Uma instância contém informação que pode ser associada a uma entrada de CacheItemPolicy cache. Por exemplo, quando uma entrada de cache está prestes a ser removida da cache, um CacheEntryUpdateArguments objeto é passado para um método de callback. A UpdatedCacheItemPolicy propriedade do CacheEntryUpdateArguments objeto pode passar uma referência a uma CacheItemPolicy instância que pode incluir detalhes de expulsão e expiração sobre a entrada na cache.
Alguns métodos nas MemoryCache classes e ObjectCache aceitam uma CacheItemPolicy instância para descrever a política de despejo ou expiração.
Notas para Herdeiros
O CacheItemPolicy tipo não é selado para que os desenvolvedores de caches personalizadas possam estendê-lo.
Construtores
| Name | Description |
|---|---|
| CacheItemPolicy() |
Inicializa uma nova instância da CacheItemPolicy classe. |
Propriedades
| Name | Description |
|---|---|
| AbsoluteExpiration |
Recebe ou define um valor que indica se uma entrada de cache deve ser despejada num determinado momento. |
| ChangeMonitors |
Obtém uma coleção de ChangeMonitor objetos associados a uma entrada de cache. |
| Priority |
Obtém ou define uma definição de prioridade que é usada para determinar se deve expulsar uma entrada de cache. |
| RemovedCallback |
Recebe ou define uma referência a um CacheEntryRemovedCallback delegado que é chamada após uma entrada ser removida da cache. |
| SlidingExpiration |
Recebe ou define um valor que indica se uma entrada de cache deve ser despejada se não tiver sido acedida num determinado período de tempo. |
| UpdateCallback |
Recebe ou define uma referência a um CacheEntryUpdateCallback delegado que é chamada antes de uma entrada de cache ser removida da cache. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |