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
| Nome | Description |
|---|---|
| AddOrGetExisting(CacheItem, CacheItemPolicy) |
Quando substituído em uma classe derivada, insere o objeto especificado CacheItem 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 para a entrada de cache, um valor de expiração absoluta e uma região opcional para adicionar o cache. |
| 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
O AddOrGetExisting método sobrecarrega a inserção de uma entrada no cache. Se já existir uma entrada de cache com uma chave correspondente, 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)
Quando substituído em uma classe derivada, insere o objeto especificado CacheItem 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.CacheItemPublic MustOverride Function AddOrGetExisting (value As CacheItem, policy As CacheItemPolicy) As CacheItemParâmetros
- value
- CacheItem
O objeto a ser inserido.
- 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 especificada; caso contrário, null.
Aplica-se a
AddOrGetExisting(String, Object, DateTimeOffset, String)
Quando substituído em uma classe derivada, insere uma entrada de cache no cache, usando uma chave, um objeto para a entrada de cache, um valor de expiração absoluta e uma região opcional para adicionar o cache.
public abstract object AddOrGetExisting(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);abstract member AddOrGetExisting : string * obj * DateTimeOffset * string -> objPublic MustOverride 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.
- value
- Object
O objeto a ser inserido.
- absoluteExpiration
- DateTimeOffset
A data e a hora fixas em que a entrada de cache expirará.
- regionName
- String
Optional. Uma região nomeada no cache à qual a entrada de cache pode ser adicionada, se as regiões forem implementadas. O valor padrão para o parâmetro opcional é null.
Retornos
Se existir uma entrada de cache com a mesma chave, 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)
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 -> objPublic MustOverride 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.
- value
- Object
O objeto a ser inserido.
- 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
Optional. Uma região nomeada no cache à qual a entrada de cache pode ser adicionada, se as regiões forem implementadas. O valor padrão para o parâmetro opcional é null.
Retornos
Se existir uma entrada de cache com a mesma chave, 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.