MemoryCache.AddOrGetExisting Método

Definição

Namespace:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Pacote:

System.Runtime.Caching v9.0.0

Insere uma entrada de cache no cache.

Sobrecargas

AddOrGetExisting(CacheItem, CacheItemPolicy)	Adiciona uma entrada de cache no cache usando a instância CacheItem especificada e os 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 de expiração absoluta.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Insere uma entrada de cache no cache usando a chave e o valor especificados, bem como os detalhes especificados para sua remoção.

Comentários

As AddOrGetExisting sobrecargas de 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 uma entrada de cache com uma chave correspondente já existir, ela retornará a entrada existente.

AddOrGetExisting(CacheItem, CacheItemPolicy)

Origem:

MemoryCache.cs

Adiciona uma entrada de cache no cache usando a instância CacheItem especificada e os 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.CacheItem

Public Overrides Function AddOrGetExisting (item As CacheItem, policy As CacheItemPolicy) As CacheItem

Parâmetros

item

CacheItem

O objeto a adicionar.

policy

CacheItemPolicy

Um objeto que contém os detalhes da remoção da entrada de cache. Esse objeto fornece mais opções de remoção do que uma expiração absoluta simples.

Retornos

CacheItem

Se houver uma entrada de cache com a mesma chave, a entrada de cache existente; caso contrário, null.

Exceções

ArgumentNullException

A propriedade Value é null.

ArgumentException

Os valores de expiração absoluta e deslizante para o objeto CacheItemPolicy são definidos como valores diferentes dos padrões dos campos InfiniteAbsoluteExpiration e NoSlidingExpiration. A classe MemoryCache 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 instância MemoryCache. A outra configuração de expiração deve ser definida como o campo InfiniteAbsoluteExpiration ou o NoSlidingExpiration.

ArgumentOutOfRangeException

A propriedade SlidingExpiration é definida com um valor menor que Zero.

- ou -

A propriedade SlidingExpiration é definida com um valor maior que um ano.

- ou -

A propriedade Priority não é um valor da enumeração CacheItemPriority.

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 sobrecargas do método Add e AddOrGetExisting não dão suporte à propriedade UpdateCallback. Portanto, para definir a propriedade UpdateCallback para uma entrada de cache, use as sobrecargas do método Set.

AddOrGetExisting(String, Object, DateTimeOffset, String)

Origem:

MemoryCache.cs

Adiciona uma entrada de cache ao cache usando a chave especificada 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 -> obj

Public Overrides Function AddOrGetExisting (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Object

Parâmetros

key

String

Um identificador exclusivo para a entrada de cache a ser adicionada.

value

Object

Os dados de entrada de cache.

absoluteExpiration

DateTimeOffset

A data e a hora fixas em que a entrada de cache vai 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, pois a classe MemoryCache não implementa regiões.

Retornos

Object

Se houver uma entrada de cache com a mesma chave, a entrada de cache existente; caso contrário, null.

Exceções

ArgumentNullException

value não é null.

NotSupportedException

regionName não é null.

ArgumentException

Os valores de expiração absoluta e deslizante para o objeto CacheItemPolicy são definidos como valores diferentes dos padrões dos campos InfiniteAbsoluteExpiration e NoSlidingExpiration. A classe MemoryCache 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 instância MemoryCache. A outra configuração de expiração deve ser definida como InfiniteAbsoluteExpiration ou NoSlidingExpiration

ArgumentOutOfRangeException

A propriedade SlidingExpiration é definida com um valor menor que Zero.

- ou -

A propriedade SlidingExpiration é definida com um valor maior que um ano.

- ou -

A propriedade Priority não é um valor da enumeração CacheItemPriority.

Comentários

Se o cache não tiver uma entrada de cache cuja chave corresponda ao key parâmetro , uma nova entrada de cache será criada e a sobrecarga do MemoryCache.AddOrGetExisting método retornará null. Se existir uma entrada de cache correspondente, a entrada existente será retornada.

Aviso

As sobrecargas do método Add e AddOrGetExisting não dão suporte à propriedade UpdateCallback. Portanto, para definir a propriedade UpdateCallback para uma entrada de cache, use as sobrecargas do método Set.

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Origem:

MemoryCache.cs

Insere uma entrada de cache no cache usando a chave e o valor especificados, bem como os detalhes especificados para sua remoção.

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 -> obj

Public Overrides Function AddOrGetExisting (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Object

Parâmetros

key

String

Um identificador exclusivo da entrada de cache a ser adicionada ou obtida.

value

Object

Os dados de entrada de cache.

policy

CacheItemPolicy

Um objeto que contém os detalhes da remoção da 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, pois a classe MemoryCache não implementa regiões.

Retornos

Object

Se uma entrada de cache correspondente já existir, uma entrada de cache; caso contrário, null.

Exceções

ArgumentNullException

value é null.

ArgumentException

Os valores de expiração absoluta e deslizante para o objeto CacheItemPolicy são definidos como valores diferentes dos padrões de InfiniteAbsoluteExpiration e NoSlidingExpiration. A classe MemoryCache 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 classe MemoryCache. 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 dá suporte apenas ao uso de um tipo de retorno de chamada por entrada de cache.

ArgumentOutOfRangeException

A propriedade SlidingExpiration é definida com um valor menor que Zero.

- ou -

O SlidingExpiration foi definido como um valor maior que um ano.

- ou -

A propriedade Priority não é um valor da enumeração CacheItemPriority.

Comentários

Aviso

As sobrecargas do método Add e AddOrGetExisting não dão suporte à propriedade UpdateCallback. Portanto, para definir a propriedade UpdateCallback para uma entrada de cache, use as sobrecargas do método Set.