DistributedCacheExtensions.SetStringAsync Método

Definição

Namespace:

Microsoft.Extensions.Caching.Distributed

Assembly:

Microsoft.Extensions.Caching.Abstractions.dll

Pacote:

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

Sobrecargas

SetStringAsync(IDistributedCache, String, String, CancellationToken)	Define de forma assíncrona uma cadeia de caracteres no cache especificado com a chave especificada.
SetStringAsync(IDistributedCache, String, String, DistributedCacheEntryOptions, CancellationToken)	Define de forma assíncrona uma cadeia de caracteres no cache especificado com a chave especificada.

SetStringAsync(IDistributedCache, String, String, CancellationToken)

Origem:

DistributedCacheExtensions.cs

Define de forma assíncrona uma cadeia de caracteres no cache especificado com a chave especificada.

public static System.Threading.Tasks.Task SetStringAsync (this Microsoft.Extensions.Caching.Distributed.IDistributedCache cache, string key, string value, System.Threading.CancellationToken token = default);

static member SetStringAsync : Microsoft.Extensions.Caching.Distributed.IDistributedCache * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

<Extension()>
Public Function SetStringAsync (cache As IDistributedCache, key As String, value As String, 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

String

Os dados a serem armazenados no cache.

token

CancellationToken

Opcional. Um CancellationToken cancelar a operação.

Retornos

Task

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

Exceções

OperationCanceledException

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

ArgumentNullException

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 SetString(IDistributedCache, String, String).

SetStringAsync(IDistributedCache, String, String, DistributedCacheEntryOptions, CancellationToken)

Origem:

DistributedCacheExtensions.cs

Define de forma assíncrona uma cadeia de caracteres no cache especificado com a chave especificada.

public static System.Threading.Tasks.Task SetStringAsync (this Microsoft.Extensions.Caching.Distributed.IDistributedCache cache, string key, string value, Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions options, System.Threading.CancellationToken token = default);

static member SetStringAsync : Microsoft.Extensions.Caching.Distributed.IDistributedCache * string * string * Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

<Extension()>
Public Function SetStringAsync (cache As IDistributedCache, key As String, value As String, options As DistributedCacheEntryOptions, 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

String

Os dados a serem armazenados no cache.

options

DistributedCacheEntryOptions

As opções de cache para a entrada.

token

CancellationToken

Opcional. Um CancellationToken cancelar a operação.

Retornos

Task

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

Exceções

OperationCanceledException

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

ArgumentNullException

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 SetString(IDistributedCache, String, String, DistributedCacheEntryOptions).