MemoryCache.AddOrGetExisting Método
Definição
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.
Insere uma entrada de cache no cache.
Sobrecargas
| Nome | Description |
|---|---|
| AddOrGetExisting(CacheItem, CacheItemPolicy) |
Adiciona uma entrada de cache ao cache usando a instância especificada CacheItem e detalhes sobre como remover a entrada. |
| AddOrGetExisting(String, Object, DateTimeOffset, String) |
Adiciona uma entrada de cache ao cache usando a chave especificada e um valor e um valor de expiração absoluta. |
| AddOrGetExisting(String, Object, CacheItemPolicy, String) |
Insere uma entrada de cache no cache usando a chave e o valor especificados e os detalhes especificados de como ela deve ser removida. |
Comentários
As AddOrGetExisting sobrecargas do método são usadas para inserir uma entrada de cache no cache. Se uma entrada de cache com uma chave correspondente não existir, esses métodos inserirão uma nova entrada. Se já existir uma entrada de cache com uma chave correspondente, ela retornará a entrada existente.
AddOrGetExisting(CacheItem, CacheItemPolicy)
- Origem:
- MemoryCache.cs
- Origem:
- MemoryCache.cs
- Origem:
- MemoryCache.cs
- Origem:
- MemoryCache.cs
Adiciona uma entrada de cache ao cache usando a instância especificada CacheItem e detalhes sobre como remover a entrada.
public:
override System::Runtime::Caching::CacheItem ^ AddOrGetExisting(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);public override System.Runtime.Caching.CacheItem AddOrGetExisting(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);override this.AddOrGetExisting : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> System.Runtime.Caching.CacheItemPublic Overrides Function AddOrGetExisting (item As CacheItem, policy As CacheItemPolicy) As CacheItemParâmetros
- item
- CacheItem
O objeto a ser adicionado.
- policy
- CacheItemPolicy
Um objeto que contém detalhes de remoção para a entrada de cache. Esse objeto fornece mais opções de remoção do que uma expiração absoluta simples.
Retornos
Se existir uma entrada de cache com a mesma chave, a entrada de cache existente; caso contrário, null.
Exceções
A propriedade Value é null.
Os valores de expiração absoluta e deslizante para o CacheItemPolicy objeto são definidos como valores diferentes dos padrões de e NoSlidingExpiration camposInfiniteAbsoluteExpiration. A MemoryCache classe não pode definir a política de expiração com base em uma combinação de uma expiração absoluta e uma expiração deslizante. Somente uma configuração de expiração pode ser definida explicitamente quando você usa a MemoryCache instância. A outra configuração de expiração deve ser definida como InfiniteAbsoluteExpiration campo ou NoSlidingExpiration campo.
A SlidingExpiration propriedade é definida como um valor menor que Zero.
- ou -
A SlidingExpiration propriedade é definida como um valor maior que um ano.
- ou -
A Priority propriedade não é um valor da CacheItemPriority enumeração.
Comentários
O item parâmetro fornece a chave e o valor usado pelo método. Se o cache tiver uma entrada de cache com a mesma chave que a chave do item parâmetro, o método retornará a entrada existente como uma CacheItem instância. Se não houver nenhuma entrada de cache existente, o método criará uma nova usando a chave e o item valor fornecidos pelo parâmetro e com os detalhes de remoção especificados por policy.
Aviso
As Add sobrecargas e AddOrGetExisting o método não dão suporte à UpdateCallback propriedade. Portanto, para definir a UpdateCallback propriedade para uma entrada de cache, use as sobrecargas do Set método.
Aplica-se a
AddOrGetExisting(String, Object, DateTimeOffset, String)
- Origem:
- MemoryCache.cs
- Origem:
- MemoryCache.cs
- Origem:
- MemoryCache.cs
- Origem:
- MemoryCache.cs
Adiciona uma entrada de cache ao cache usando a chave especificada e um valor e um valor de expiração absoluta.
public override object AddOrGetExisting(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);override this.AddOrGetExisting : string * obj * DateTimeOffset * string -> objPublic Overrides Function AddOrGetExisting (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As ObjectParâmetros
- key
- String
Um identificador exclusivo para a entrada de cache a ser adicionada.
- value
- Object
Os dados da entrada de cache.
- absoluteExpiration
- DateTimeOffset
A data e a hora fixas em que a entrada de cache expirará.
- regionName
- String
Uma região nomeada no cache à qual uma entrada de cache pode ser adicionada. Não passe um valor para esse parâmetro. Esse parâmetro é null por padrão, porque a MemoryCache classe não implementa regiões.
Retornos
Se existir uma entrada de cache com a mesma chave, a entrada de cache existente; caso contrário, null.
Exceções
value não nullé .
regionName não nullé .
Os valores de expiração absoluta e deslizante para o CacheItemPolicy objeto são definidos como valores diferentes dos padrões de e NoSlidingExpiration camposInfiniteAbsoluteExpiration. A MemoryCache classe não pode definir a política de expiração com base em uma combinação de uma expiração absoluta e uma expiração deslizante. Somente uma configuração de expiração pode ser definida explicitamente quando você usa a MemoryCache instância. A outra configuração de expiração deve ser definida como InfiniteAbsoluteExpiration ou NoSlidingExpiration
A SlidingExpiration propriedade é definida como um valor menor que Zero.
- ou -
A SlidingExpiration propriedade é definida como um valor maior que um ano.
- ou -
A Priority propriedade não é um valor da CacheItemPriority enumeração.
Comentários
Se o cache não tiver uma entrada de cache cuja chave corresponde ao key parâmetro, uma nova entrada de cache será criada e a sobrecarga do MemoryCache.AddOrGetExisting método retornará null. Se houver uma entrada de cache correspondente, a entrada existente será retornada.
Aviso
As Add sobrecargas e AddOrGetExisting o método não dão suporte à UpdateCallback propriedade. Portanto, para definir a UpdateCallback propriedade para uma entrada de cache, use as sobrecargas do Set método.
Aplica-se a
AddOrGetExisting(String, Object, CacheItemPolicy, String)
- Origem:
- MemoryCache.cs
- Origem:
- MemoryCache.cs
- Origem:
- MemoryCache.cs
- Origem:
- MemoryCache.cs
Insere uma entrada de cache no cache usando a chave e o valor especificados e os detalhes especificados de como ela deve ser removida.
public override object AddOrGetExisting(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);override this.AddOrGetExisting : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> objPublic Overrides Function AddOrGetExisting (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As ObjectParâmetros
- key
- String
Um identificador exclusivo para a entrada de cache para adicionar ou obter.
- value
- Object
Os dados da entrada de cache.
- policy
- CacheItemPolicy
Um objeto que contém detalhes de remoção para a entrada de cache. Esse objeto fornece mais opções de remoção do que uma expiração absoluta simples.
- regionName
- String
Uma região nomeada no cache à qual uma entrada de cache pode ser adicionada. Não passe um valor para esse parâmetro. Por padrão, esse parâmetro é null, porque a MemoryCache classe não implementa regiões.
Retornos
Se já existir uma entrada de cache correspondente, uma entrada de cache; caso contrário, null.
Exceções
value é null.
Os valores de expiração absoluta e deslizante do CacheItemPolicy objeto são definidos como valores diferentes dos padrões de InfiniteAbsoluteExpiration e NoSlidingExpiration. A MemoryCache classe não pode definir a política de expiração com base em uma combinação de uma expiração absoluta e deslizante. Somente uma configuração de expiração pode ser definida explicitamente quando você usa a MemoryCache classe. A outra configuração deve ser definida como InfiniteAbsoluteExpiration ou NoSlidingExpiration.
- ou -
O retorno de chamada de remoção e o retorno de chamada de atualização foram especificados para CacheItemPolicy. O MemoryCache único dá suporte ao uso de um tipo de retorno de chamada por entrada de cache.
A SlidingExpiration propriedade é definida como um valor menor que Zero.
- ou -
O SlidingExpiration valor foi definido como maior que um ano.
- ou -
A Priority propriedade não é um valor da CacheItemPriority enumeração.
Comentários
Aviso
As Add sobrecargas e AddOrGetExisting o método não dão suporte à UpdateCallback propriedade. Portanto, para definir a UpdateCallback propriedade para uma entrada de cache, use as sobrecargas do Set método.
