ObjectCache.AddOrGetExisting Método

Definição

Namespace:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Pacote:

System.Runtime.Caching v8.0.0

Quando substituído em uma classe derivada, tenta inserir uma entrada de cache no cache e retorna uma entrada de cache existente com uma chave correspondente.

Sobrecargas

AddOrGetExisting(CacheItem, CacheItemPolicy)	Quando substituído em uma classe derivada, insere o objeto CacheItem especificado no cache, especificando informações sobre como a entrada será removida.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Quando substituído em uma classe derivada, insere uma entrada de cache no cache, usando uma chave, um objeto na entrada de cache, um valor de expiração absoluta e uma região opcional na qual o cache será adicionado.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Quando substituído em uma classe derivada, insere uma entrada de cache no cache, especificando uma chave e um valor para a entrada de cache e informações sobre como a entrada será removida.

Comentários

As AddOrGetExisting sobrecargas de método inserem uma entrada no cache. Se uma entrada de cache com uma chave correspondente já existir, ela retornará a entrada existente. A entrada de cache pode ser um CacheItem objeto ou um objeto genérico.

Há uma diferença entre as AddOrGetExisting sobrecargas e as Add sobrecargas. Quando esses métodos sobrecarregados tentam inserir uma entrada de cache, se uma entrada existente for encontrada que tenha uma chave que corresponda a uma entrada de cache inserida existente, as AddOrGetExisting sobrecargas retornarão a entrada de cache existente. As Add sobrecargas não.

AddOrGetExisting(CacheItem, CacheItemPolicy)

Origem:

ObjectCache.cs

Quando substituído em uma classe derivada, insere o objeto CacheItem especificado no cache, especificando informações sobre como a entrada será removida.

public:
 abstract System::Runtime::Caching::CacheItem ^ AddOrGetExisting(System::Runtime::Caching::CacheItem ^ value, System::Runtime::Caching::CacheItemPolicy ^ policy);

public abstract System.Runtime.Caching.CacheItem AddOrGetExisting (System.Runtime.Caching.CacheItem value, System.Runtime.Caching.CacheItemPolicy policy);

abstract member AddOrGetExisting : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> System.Runtime.Caching.CacheItem

Public MustOverride Function AddOrGetExisting (value As CacheItem, policy As CacheItemPolicy) As CacheItem

Parâmetros

value

CacheItem

O objeto a ser inserido.

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 especificada; caso contrário, null.

AddOrGetExisting(String, Object, DateTimeOffset, String)

Origem:

ObjectCache.cs

Quando substituído em uma classe derivada, insere uma entrada de cache no cache, usando uma chave, um objeto na entrada de cache, um valor de expiração absoluta e uma região opcional na qual o cache será adicionado.

public abstract object AddOrGetExisting (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

abstract member AddOrGetExisting : string * obj * DateTimeOffset * string -> obj

Public MustOverride 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 da entrada de cache.

value

Object

O objeto a ser inserido.

absoluteExpiration

DateTimeOffset

A data e a hora fixas em que a entrada de cache vai expirar.

regionName

String

Opcional. Uma região nomeada no cache à qual a entrada de cache pode ser adicionada, se as regiões forem implementadas. O valor padrão do parâmetro opcional é null.

Retornos

Object

Se houver uma entrada de cache com a mesma chave, será o valor da entrada de cache especificada; caso contrário, null.

Comentários

Essa AddOrGetExisting(String, Object, DateTimeOffset, String) sobrecarga de método retorna um valor de objeto, não um CacheItem objeto .

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Origem:

ObjectCache.cs

Quando substituído em uma classe derivada, insere uma entrada de cache no cache, especificando uma chave e um valor para a entrada de cache e informações sobre como a entrada será removida.

public abstract object AddOrGetExisting (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

abstract member AddOrGetExisting : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> obj

Public MustOverride 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.

value

Object

O objeto a ser inserido.

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

Opcional. Uma região nomeada no cache à qual a entrada de cache pode ser adicionada, se as regiões forem implementadas. O valor padrão do parâmetro opcional é null.

Retornos

Object

Se houver uma entrada de cache com a mesma chave, será o valor da entrada de cache especificada; caso contrário, null.

Comentários

O AddOrGetExisting(String, Object, CacheItemPolicy, String) método retorna um valor de objeto, não um CacheItem objeto .