ObjectCache.AddOrGetExisting Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Quando sobrescrito numa classe derivada, tenta inserir uma entrada de cache na cache e devolve uma entrada de cache existente com uma chave correspondente.
Sobrecargas
| Name | Description |
|---|---|
| AddOrGetExisting(CacheItem, CacheItemPolicy) |
Quando é sobreposto numa classe derivada, insere o objeto especificado CacheItem na cache, especificando informações sobre como a entrada será expulsa. |
| AddOrGetExisting(String, Object, DateTimeOffset, String) |
Quando sobrescrito numa classe derivada, insere uma entrada de cache na cache, usando uma chave, um objeto para a entrada de cache, um valor absoluto de expiração e uma região opcional para adicionar a cache. |
| AddOrGetExisting(String, Object, CacheItemPolicy, String) |
Quando sobrescrito numa classe derivada, insere uma entrada de cache na cache, especificando uma chave e um valor para a entrada de cache, e informação sobre como a entrada será eliminada. |
Observações
A AddOrGetExisting sobrecarga do método insere uma entrada na cache. Se já existir uma entrada de cache com uma chave correspondente, devolvem 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 estes métodos sobrecarregados tentam inserir uma entrada de cache, se for encontrada uma entrada existente com uma chave que corresponde a uma entrada de cache inserida, as AddOrGetExisting sobrecargas devolvem a entrada de cache existente. As Add sobrecargas não.
AddOrGetExisting(CacheItem, CacheItemPolicy)
Quando é sobreposto numa classe derivada, insere o objeto especificado CacheItem na cache, especificando informações sobre como a entrada será expulsa.
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 inserir.
- policy
- CacheItemPolicy
Um objeto que contém detalhes de expulsão para a entrada da cache. Este objeto oferece mais opções de despejo do que uma simples expiração absoluta.
Devoluções
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 sobrescrito numa classe derivada, insere uma entrada de cache na cache, usando uma chave, um objeto para a entrada de cache, um valor absoluto de expiração e uma região opcional para adicionar a cache.
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 único para a entrada da cache.
- value
- Object
O objeto a inserir.
- absoluteExpiration
- DateTimeOffset
A data e hora fixas em que a entrada do cache expirará.
- regionName
- String
Optional. Uma região nomeada na cache à qual a entrada da cache pode ser adicionada, se as regiões forem implementadas. O valor padrão para o parâmetro opcional é null.
Devoluções
Se existir uma entrada de cache com a mesma chave, o valor da entrada de cache especificada; caso contrário, null.
Observações
Esta AddOrGetExisting(String, Object, DateTimeOffset, String) sobrecarga de métodos devolve um valor de objeto, não um CacheItem objeto.
Aplica-se a
AddOrGetExisting(String, Object, CacheItemPolicy, String)
Quando sobrescrito numa classe derivada, insere uma entrada de cache na cache, especificando uma chave e um valor para a entrada de cache, e informação sobre como a entrada será eliminada.
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 único para a entrada da cache.
- value
- Object
O objeto a inserir.
- policy
- CacheItemPolicy
Um objeto que contém detalhes de expulsão para a entrada da cache. Este objeto oferece mais opções de despejo do que uma simples expiração absoluta.
- regionName
- String
Optional. Uma região nomeada na cache à qual a entrada da cache pode ser adicionada, se as regiões forem implementadas. O valor padrão para o parâmetro opcional é null.
Devoluções
Se existir uma entrada de cache com a mesma chave, o valor da entrada de cache especificada; caso contrário, null.
Observações
O AddOrGetExisting(String, Object, CacheItemPolicy, String) método devolve um valor de objeto, não um CacheItem objeto.