MemoryDistributedCache.SetAsync Metoda

Definice

Obor názvů:

Microsoft.Extensions.Caching.Distributed

Sestavení:

Microsoft.Extensions.Caching.Memory.dll

Balíček:

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

Zdroj:

MemoryDistributedCache.cs

Nastaví hodnotu s daným klíčem.

public System.Threading.Tasks.Task SetAsync (string key, byte[] value, Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions options, System.Threading.CancellationToken token = default);

abstract member SetAsync : string * byte[] * Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.SetAsync : string * byte[] * Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function SetAsync (key As String, value As Byte(), options As DistributedCacheEntryOptions, Optional token As CancellationToken = Nothing) As Task

Parametry

key

String

Řetězec identifikující požadovanou hodnotu.

value

Byte[]

Hodnota, která se má nastavit v mezipaměti.

options

DistributedCacheEntryOptions

Možnosti mezipaměti pro hodnotu.

token

CancellationToken

Nepovinný parametr. Slouží CancellationToken k šíření oznámení, že operace by měla být zrušena.

Návraty

Task

Jedná se Task o asynchronní operaci.

Implementuje

SetAsync(String, Byte[], DistributedCacheEntryOptions, CancellationToken)

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Set(String, Byte[], DistributedCacheEntryOptions).