MemoryDistributedCache.SetAsync Metoda

Definicja

Przestrzeń nazw:

Microsoft.Extensions.Caching.Distributed

Zestaw:

Microsoft.Extensions.Caching.Memory.dll

Pakiet:

Microsoft.Extensions.Caching.Memory v9.0.1

Źródło:

MemoryDistributedCache.cs

Asynchronicznie ustawia określony element skojarzony z kluczem w IMemoryCache jako tablicę bajtów.

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

Klucz elementu do ustawienia.

value

Byte[]

Wartość tablicy bajtów elementu do ustawienia.

options

DistributedCacheEntryOptions

Opcje pamięci podręcznej elementu do ustawienia.

token

CancellationToken

CancellationToken do użycia do anulowania operacji.

Zwraca

Task

Zadanie ustawiania wartości tablicy bajtów skojarzonej z określonym kluczem w pamięci podręcznej.

Implementuje

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

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez Set(String, Byte[], DistributedCacheEntryOptions).