Compartilhar via


ObjectCache.AddOrGetExisting Método

Definição

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
Origem:
ObjectCache.cs
Origem:
ObjectCache.cs
Origem:
ObjectCache.cs
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

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

Aplica-se a

AddOrGetExisting(String, Object, DateTimeOffset, String)

Origem:
ObjectCache.cs
Origem:
ObjectCache.cs
Origem:
ObjectCache.cs
Origem:
ObjectCache.cs
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

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 .

Aplica-se a

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Origem:
ObjectCache.cs
Origem:
ObjectCache.cs
Origem:
ObjectCache.cs
Origem:
ObjectCache.cs
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

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 .

Aplica-se a