ObjectCache.Add Método

Definição

Namespace:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Pacote:

System.Runtime.Caching v8.0.0

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

Add(CacheItem, CacheItemPolicy)	Quando substituído em uma classe derivada, tenta inserir uma entrada de cache no cache como uma instância CacheItem 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 de 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 tipado CacheItem ou um objeto genérico.

As AddOrGetExisting sobrecargas de método e as sobrecargas de 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, as sobrecargas de AddOrGetExisting método retornarão a 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 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)

Origem:

ObjectCache.cs

Quando substituído em uma classe derivada, tenta inserir uma entrada de cache no cache como uma instância CacheItem 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 adicionar.

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

Boolean

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

Comentários

As Add sobrecargas de 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 de AddOrGetExisting método.

Add(String, Object, DateTimeOffset, String)

Origem:

ObjectCache.cs

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

regionName

String

Opcional. 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 for bem-sucedida ou false se já houver uma entrada no cache com a mesma chave que key.

Comentários

As Add sobrecargas de 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 de AddOrGetExisting método.

Add(String, Object, CacheItemPolicy, String)

Origem:

ObjectCache.cs

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

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 de 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 de AddOrGetExisting método.