ObjectCache.Add Método

Definição

Namespace:
System.Runtime.Caching
Assembly:
System.Runtime.Caching.dll

Quando substituído em uma classe derivada, insere uma entrada de cache no cache, sem exigir que uma entrada de cache existente com uma chave correspondente seja retornada.

Sobrecargas

Nome Description
Add(CacheItem, CacheItemPolicy)

Quando substituído em uma classe derivada, tenta inserir uma entrada de cache no cache como uma CacheItem instância e adiciona detalhes sobre como a entrada deve ser removida.
Add(String, Object, DateTimeOffset, String)

Quando substituído em uma classe derivada, insere uma entrada de cache no cache sem substituir nenhuma entrada de cache existente.
Add(String, Object, CacheItemPolicy, String)

Quando substituído em uma classe derivada, insere uma entrada de cache no cache, especificando informações sobre como a entrada será removida.

Comentários

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

As AddOrGetExisting sobrecargas do método e as sobrecargas do Add método têm uma diferença significativa. Quando esses métodos inserem uma entrada de cache, se uma entrada correspondente for encontrada no cache, o AddOrGetExisting método sobrecarrega o retorno da entrada de cache existente, mas as sobrecargas do Add método não. Ter essas sobrecargas de método diferentes permite que os chamadores otimizem seu código com base em se eles precisam da entrada de cache existente. Em caches distribuídos, retornar um valor existente usando o AddOrGetExisting método pode ser mais caro do que retornar um valor booliano usando Add o método.

Add(CacheItem, CacheItemPolicy)

Quando substituído em uma classe derivada, tenta inserir uma entrada de cache no cache como uma CacheItem instância e adiciona detalhes sobre como a entrada deve ser removida.

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 objeto a ser adicionado.

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

Boolean

true se a inserção tiver sido bem-sucedida ou false se já houver uma entrada no cache que tenha a mesma chave itemque .

Comentários

As Add sobrecargas do método são virtuais (não abstratas) na ObjectCache classe, porque o Add método chama AddOrGetExistinginternamente . Isso reduz o número de sobrecargas de método que um implementador de cache precisa fornecer. Se uma implementação de cache não exigir nenhum comportamento especial para o Add método, ela poderá apenas implementar as sobrecargas do AddOrGetExisting método.

Aplica-se a

Add(String, Object, DateTimeOffset, String)

Quando substituído em uma classe derivada, insere uma entrada de cache no cache sem substituir nenhuma entrada de cache 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 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á. Esse parâmetro é necessário quando o Add método é chamado.

regionName
String

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

Retornos

Boolean

true se a inserção tiver sido bem-sucedida ou false se já houver uma entrada no cache que tenha a mesma chave keyque .

Comentários

As Add sobrecargas do método são virtuais (não abstratas) na ObjectCache classe, porque o Add método chama AddOrGetExistinginternamente . Isso reduz o número de sobrecargas de método que um implementador de cache precisa fornecer. Se uma implementação de cache não exigir nenhum comportamento especial para o Add método, ela poderá apenas implementar as sobrecargas do AddOrGetExisting método.

Aplica-se a

Add(String, Object, CacheItemPolicy, String)

Quando substituído em uma classe derivada, insere uma entrada de cache no cache, especificando informações sobre como a entrada será removida.

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

Boolean

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

Comentários

As Add sobrecargas do método são virtuais (não abstratas) na ObjectCache classe, porque o Add método chama AddOrGetExistinginternamente . Isso reduz o número de sobrecargas de método que um implementador de cache precisa fornecer. Se uma implementação de cache não exigir nenhum comportamento especial para o Add método, ela poderá apenas implementar as sobrecargas do AddOrGetExisting método.

Aplica-se a