Ler em inglês

Partilhar via


ObjectCache.Set Método

Definição

Quando substituído em uma classe derivada, insere uma entrada de cache no cache.

Sobrecargas

Set(CacheItem, CacheItemPolicy)

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

Set(String, Object, DateTimeOffset, String)

Quando substituído em uma classe derivada, insere uma entrada de cache no cache, especificando detalhes de expiração com base em tempo.

Set(String, Object, CacheItemPolicy, String)

Quando substituído em uma classe derivada, insere uma entrada de cache no cache.

Comentários

O comportamento típico dos Set métodos de sobrecarga é uma operação de inserção ou atualização. Uma entrada de cache será inserida como uma nova entrada se a entrada especificada não existir ou a entrada de cache for atualizada com um novo valor se ela já existir.

Set(CacheItem, CacheItemPolicy)

Origem:
ObjectCache.cs
Origem:
ObjectCache.cs
Origem:
ObjectCache.cs

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

C#
public abstract void Set(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

Parâmetros

item
CacheItem

O item de cache 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.

Comentários

Se a chave para item não existir, item será inserida como uma nova entrada de cache. Se existir um item com uma chave correspondente item , o valor de item será usado para atualizar ou substituir o valor da entrada de cache existente.

Aplica-se a

.NET 10 (package-provided) e outras versões
Produto Versões
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

Set(String, Object, DateTimeOffset, String)

Origem:
ObjectCache.cs
Origem:
ObjectCache.cs
Origem:
ObjectCache.cs

Quando substituído em uma classe derivada, insere uma entrada de cache no cache, especificando detalhes de expiração com base em tempo.

C#
public abstract void Set(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

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.

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.

Comentários

Se um item correspondente key não existir no cache value e key for usado para inserir como uma nova entrada de cache. Se houver um item com uma chave correspondente item , a entrada de cache será atualizada ou substituída usando value.

Aplica-se a

.NET 10 (package-provided) e outras versões
Produto Versões
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

Set(String, Object, CacheItemPolicy, String)

Origem:
ObjectCache.cs
Origem:
ObjectCache.cs
Origem:
ObjectCache.cs

Quando substituído em uma classe derivada, insere uma entrada de cache no cache.

C#
public abstract void Set(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

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.

Comentários

Essa sobrecarga de método permite que você forneça mais detalhes de remoção ou expiração do que aqueles disponíveis na expiração absoluta baseada em tempo.

Se um item correspondente key não existir no cache value e key for usado para inserir como uma nova entrada de cache. Se houver um item com uma chave correspondente item , a entrada de cache será atualizada ou substituída usando value.

Aplica-se a

.NET 10 (package-provided) e outras versões
Produto Versões
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)