ObjectCache.Add Método

Definição

Espaço de Nomes:
System.Runtime.Caching
Assemblagem:
System.Runtime.Caching.dll

Quando sobreposta numa classe derivada, insere uma entrada de cache no cache, sem exigir que uma entrada de cache existente com uma chave correspondente seja devolvida.

Sobrecargas

Name Description
Add(CacheItem, CacheItemPolicy)

Quando sobrescrito numa classe derivada, tenta inserir uma entrada de cache na cache como CacheItem uma instância e adiciona detalhes sobre como a entrada deve ser eliminada.
Add(String, Object, DateTimeOffset, String)

Quando sobrescrito numa classe derivada, insere uma entrada de cache na cache sem sobrescrever nenhuma entrada existente.
Add(String, Object, CacheItemPolicy, String)

Quando sobrescrito numa classe derivada, insere uma entrada de cache na cache, especificando informações sobre como a entrada será eliminada.

Observações

As Add sobrecargas de método tentam inserir uma entrada de cache no cache, sem sobrescrever ou remover uma entrada de cache existente que tenha a mesma chave. A entrada do cache pode ser um objeto tipado CacheItem ou um objeto genérico.

As AddOrGetExisting sobrecargas de método e Add as sobrecargas de método têm uma diferença significativa. Quando estes métodos inserem uma entrada na cache, se for encontrada uma entrada correspondente na cache, as AddOrGetExisting sobrecargas de métodos devolvem a entrada existente na cache, mas as Add sobrecargas de métodos não. Ter estas diferentes sobrecargas de métodos permite aos chamadores otimizar o seu código com base na necessidade da entrada existente na cache. Em caches distribuídos, devolver um valor existente usando o AddOrGetExisting método pode ser mais caro do que devolver um valor Booleano usando Add o método.

Add(CacheItem, CacheItemPolicy)

Quando sobrescrito numa classe derivada, tenta inserir uma entrada de cache na cache como CacheItem uma instância e adiciona detalhes sobre como a entrada deve ser eliminada.

public:
 virtual bool Add(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);
public virtual bool Add(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);
abstract member Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
override this.Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
Public Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Boolean

Parâmetros

item
CacheItem

O objetivo a acrescentar.

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

Boolean

true se a inserção foi bem-sucedida, ou false se já existir uma entrada na cache com a mesma chave que item.

Observações

As Add sobrecargas de métodos são virtuais (não abstratas) na ObjectCache classe, porque o Add método chama AddOrGetExistinginternamente . Isto reduz o número de sobrecargas de métodos que um implementador de cache tem de fornecer. Se uma implementação de cache não exigir qualquer comportamento especial para o Add método, pode simplesmente implementar as AddOrGetExisting sobrecargas do método.

Aplica-se a

Add(String, Object, DateTimeOffset, String)

Quando sobrescrito numa classe derivada, insere uma entrada de cache na cache sem sobrescrever nenhuma entrada existente.

public virtual bool Add(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);
abstract member Add : string * obj * DateTimeOffset * string -> bool
override this.Add : string * obj * DateTimeOffset * string -> bool
Public Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Boolean

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á. Este parâmetro é necessário quando o Add método é chamado.

regionName
String

Optional. Uma região nomeada na cache à qual a entrada da cache pode ser adicionada, se as regiões forem implementadas. Como as regiões não estão implementadas no Framework 4 .NET, o valor padrão é null.

Devoluções

Boolean

true se a inserção foi bem-sucedida, ou false se já existir uma entrada na cache com a mesma chave que key.

Observações

As Add sobrecargas de métodos são virtuais (não abstratas) na ObjectCache classe, porque o Add método chama AddOrGetExistinginternamente . Isto reduz o número de sobrecargas de métodos que um implementador de cache tem de fornecer. Se uma implementação de cache não exigir qualquer comportamento especial para o Add método, pode simplesmente implementar as AddOrGetExisting sobrecargas do método.

Aplica-se a

Add(String, Object, CacheItemPolicy, String)

Quando sobrescrito numa classe derivada, insere uma entrada de cache na cache, especificando informações sobre como a entrada será eliminada.

public virtual bool Add(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);
abstract member Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
override this.Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
Public Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Boolean

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

Boolean

true Se a tentativa de inserção for bem-sucedida, ou false se já houver uma entrada na cache com a mesma chave que key.

Observações

As Add sobrecargas de métodos são virtuais (não abstratas) na ObjectCache classe, porque o Add método chama AddOrGetExistinginternamente . Isto reduz o número de sobrecargas de métodos que um implementador de cache tem de fornecer. Se uma implementação de cache não exigir qualquer comportamento especial para o Add método, pode simplesmente implementar as AddOrGetExisting sobrecargas do método.

Aplica-se a