DistributedCacheExtensions.SetAsync Método

Definição

Namespace:

Microsoft.Extensions.Caching.Distributed

Assembly:

Microsoft.Extensions.Caching.Abstractions.dll

Pacote:

Microsoft.Extensions.Caching.Abstractions v9.0.0-preview.4.24266.19

Origem:

DistributedCacheExtensions.cs

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 armazenar no cache.

token

CancellationToken

Opcional. Um CancellationToken para cancelar a operação.

Retornos

Task

Uma tarefa que representa a operação de conjuntos assíncrona.

Exceções

ArgumentNullException

key ou value é nulo.

OperationCanceledException

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

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[]).