Compartilhar via


DistributedCacheExtensions.GetStringAsync Método

Definição

Obtém de forma assíncrona uma cadeia de caracteres do cache especificado com a chave especificada.

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

Parâmetros

cache
IDistributedCache

O cache no qual armazenar os dados.

key
String

A chave para a qual obter os dados armazenados.

token
CancellationToken

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

Retornos

Uma tarefa que obtém o valor da cadeia de caracteres da chave de cache armazenada.

Exceções

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 a contraparte síncrona 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 GetString(IDistributedCache, String).

Aplica-se a