DistributedCacheExtensions.SetStringAsync Metoda

Definicja

Przestrzeń nazw:

Microsoft.Extensions.Caching.Distributed

Zestaw:

Microsoft.Extensions.Caching.Abstractions.dll

Pakiet:

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

Przeciążenia

SetStringAsync(IDistributedCache, String, String, CancellationToken)	Asynchronicznie ustawia ciąg w określonej pamięci podręcznej przy użyciu określonego klucza.
SetStringAsync(IDistributedCache, String, String, DistributedCacheEntryOptions, CancellationToken)	Asynchronicznie ustawia ciąg w określonej pamięci podręcznej przy użyciu określonego klucza.

SetStringAsync(IDistributedCache, String, String, CancellationToken)

Źródło:

DistributedCacheExtensions.cs

Asynchronicznie ustawia ciąg w określonej pamięci podręcznej przy użyciu określonego klucza.

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

Parametry

cache

IDistributedCache

Pamięć podręczna, w której mają być przechowywane dane.

key

String

Klucz do przechowywania danych.

value

String

Dane do przechowywania w pamięci podręcznej.

token

CancellationToken

Fakultatywny. CancellationToken, aby anulować operację.

Zwraca

Task

Zadanie reprezentujące operację zestawu asynchronicznego.

Wyjątki

OperationCanceledException

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

ArgumentNullException

key lub value ma wartość null.

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

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

Źródło:

DistributedCacheExtensions.cs

Asynchronicznie ustawia ciąg w określonej pamięci podręcznej przy użyciu określonego klucza.

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

Parametry

cache

IDistributedCache

Pamięć podręczna, w której mają być przechowywane dane.

key

String

Klucz do przechowywania danych.

value

String

Dane do przechowywania w pamięci podręcznej.

options

DistributedCacheEntryOptions

Opcje pamięci podręcznej wpisu.

token

CancellationToken

Fakultatywny. CancellationToken, aby anulować operację.

Zwraca

Task

Zadanie reprezentujące operację zestawu asynchronicznego.

Wyjątki

OperationCanceledException

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

ArgumentNullException

key lub value ma wartość null.

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