Partilhar via


DistributedCacheExtensions.SetAsync Método

Definição

Define de forma assíncrona uma sequência de bytes no cache especificado com a chave especificada.

public static System.Threading.Tasks.Task SetAsync (this Microsoft.Extensions.Caching.Distributed.IDistributedCache cache, string key, byte[] value, System.Threading.CancellationToken token = default);
static member SetAsync : Microsoft.Extensions.Caching.Distributed.IDistributedCache * string * byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task
<Extension()>
Public Function SetAsync (cache As IDistributedCache, key As String, value As Byte(), Optional token As CancellationToken = Nothing) As Task

Parâmetros

cache
IDistributedCache

O cache no qual armazenar os dados.

key
String

A chave na qual armazenar os dados.

value
Byte[]

Os dados a serem armazenados no cache.

token
CancellationToken

Opcional. Um CancellationToken cancelar a operação.

Retornos

Uma tarefa que representa a operação de conjunto assíncrono.

Exceções

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

key ou value é nulo.

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Set(IDistributedCache, String, Byte[]).

Aplica-se a