Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe Cache

 

Publicado: abril de 2016

Implementa o cache para um aplicativo Web. Essa classe não pode ser herdada.

Namespace:   System.Web.Caching
Assembly:  System.Web (em System.Web.dll)

System.Object
  System.Web.Caching.Cache

public sealed class Cache : IEnumerable

NomeDescrição
System_CAPS_pubmethodCache()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Inicializa uma nova instância da classe Cache.

NomeDescrição
System_CAPS_pubpropertyCount

Obtém o número de itens armazenados no cache.

System_CAPS_pubpropertyEffectivePercentagePhysicalMemoryLimit

Obtém o percentual de memória física que pode ser consumido por um aplicativo antes que o ASP.NET comece a remover itens do cache.

System_CAPS_pubpropertyEffectivePrivateBytesLimit

Obtém o número de bytes disponíveis para o cache.

System_CAPS_pubpropertyItem[String]

Obtém ou define o item de cache na chave especificada.

NomeDescrição
System_CAPS_pubmethodAdd(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)

Adiciona o item especificado ao objeto Cache com dependências, políticas de término e prioridade, bem como um delegado que pode ser usado para notificar o aplicativo quando o item inserido é removido do Cache.

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_pubmethodGet(String)

Recupera o item especificado do objeto Cache.

System_CAPS_pubmethodGetEnumerator()

Recupera um enumerador de dicionário usado para iterar pelas configurações de chave e os valores contidos no cache.

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodInsert(String, Object)

Insere um item no objeto Cache com uma chave de cache para fazer referência à sua localização, usando os valores padrão fornecidos pela enumeração CacheItemPriority.

System_CAPS_pubmethodInsert(String, Object, CacheDependency)

Insere um objeto no Cache que tem dependências de arquivo ou de chave.

System_CAPS_pubmethodInsert(String, Object, CacheDependency, DateTime, TimeSpan)

Insere um objeto no Cache com dependências e políticas de vencimento.

System_CAPS_pubmethodInsert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)

Insere um objeto no objeto Cache com dependências, políticas de expiração e de prioridade, além de um delegado que você pode usar para notificar o aplicativo quando o item inserido é removido do Cache.

System_CAPS_pubmethodInsert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)

Insere um objeto no objeto Cache junto com as dependências, políticas de expiração e um delegado que pode ser usado para notificar o aplicativo antes que o item seja removido do cache.

System_CAPS_pubmethodRemove(String)

Remove o item especificado do objeto Cache do aplicativo.

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

NomeDescrição
System_CAPS_pubfieldSystem_CAPS_staticNoAbsoluteExpiration

Usado no absoluteExpiration parâmetro em um Insert chamada de método para indicar que o item nunca expirará. Este campo é somente leitura.

System_CAPS_pubfieldSystem_CAPS_staticNoSlidingExpiration

Usado como o parâmetro slidingExpiration em um método Insert ou Add chamado para desabilitar as expirações deslizantes. Este campo é somente leitura.

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethodIEnumerable.GetEnumerator()

Retorna um enumerador que pode iterar por meio de Cache coleção de objetos.

NomeDescrição
System_CAPS_pubmethodAsParallel()

Sobrecarregado. Permite a paralelização de uma consulta. (Definido pelo ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Sobrecarregado. Converte um IEnumerable em um IQueryable.(Definido pelo Queryable.)

System_CAPS_pubmethodCast<TResult>()

Converte os elementos de um IEnumerable para o tipo especificado.(Definido pelo Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtra os elementos de um IEnumerable com base em um tipo especificado.(Definido pelo Enumerable.)

Uma instância dessa classe é criada por domínio de aplicativo, e ele permanece válido desde que o domínio de aplicativo permanece ativo. Informações sobre uma instância desta classe estão disponíveis por meio de Cache propriedade do HttpContext objeto ou o Cache propriedade do Page objeto.

System_CAPS_noteObservação

O Cache classe não se destina a uso fora dos aplicativos ASP.NET. Ele foi criado e testado para uso no ASP.NET para fornecer armazenamento em cache para aplicativos da Web. Para outros tipos de aplicativos, como aplicativos de console ou aplicativos de formulários do Windows, use o ObjectCache classe.

O exemplo a seguir é uma página que mostra o valor atribuído a um item no cache de usuários e, em seguida, notifica quando o item é removido do cache. Ele cria um RemovedCallback método, que tem a assinatura do CacheItemRemovedCallback representante, para notificar os usuários quando o item de cache é removido, e usa o CacheItemRemovedReason enumeração para saber por que ele foi removido. Além disso, ele usa o Cache.Item propriedade para adicionar objetos ao cache e recuperar o valor desses objetos. No AddItemToCache método, ele usa o Cache.Add método para adicionar um item ao cache. Para usar o CacheItemRemovedCallback delegado, você deve adicionar um item ao cache com esse método ou o Cache.Insert método, assim que o que o ASP.NET automaticamente pode tornar o método correto chama quando o item for removido. Personalizado RemoveItemFromCache método usa o Cache.Remove método para excluir explicitamente o item do cache, fazendo com que o RemovedCallback método ser chamado.

System_CAPS_noteObservação

A instância do Cache que é acessada pelo trecho a seguir é um membro do Page objeto que herda este exemplo.

<html>
 <Script runat=server language="C#">
    static bool itemRemoved = false;
    static CacheItemRemovedReason reason;
    CacheItemRemovedCallback onRemove = null;

    public void RemovedCallback(String k, Object v, CacheItemRemovedReason r){
      itemRemoved = true;
      reason = r;
    }

    public void AddItemToCache(Object sender, EventArgs e) {
        itemRemoved = false;

        onRemove = new CacheItemRemovedCallback(this.RemovedCallback);

        if (Cache["Key1"] == null)
          Cache.Add("Key1", "Value 1", null, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove);
    }

    public void RemoveItemFromCache(Object sender, EventArgs e) {
        if(Cache["Key1"] != null)
          Cache.Remove("Key1");
    }
 </Script>
 <body>
  <Form runat="server">
   <input type=submit OnServerClick="AddItemToCache" value="Add Item To Cache" runat="server"/>
   <input type=submit OnServerClick="RemoveItemFromCache" value="Remove Item From Cache" runat="server"/>
  </Form>
  <% if (itemRemoved) {
        Response.Write("RemovedCallback event raised.");
        Response.Write("<BR>");
        Response.Write("Reason: <B>" + reason.ToString() + "</B>");
     }
     else {
        Response.Write("Value of cache key: <B>" + Server.HtmlEncode(Cache["Key1"] as string) + "</B>");
     }
  %>
 </body>
</html>

.NET Framework
Disponível desde 1.1

Esse tipo é de Thread de segurança.

Retornar ao início
Mostrar: