DistributedCacheExtensions.GetStringAsync 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

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

Task<String>

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

Exceções

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