ObjectCache.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.
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
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
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
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 .