DistributedCacheExtensions.SetAsync 方法

定義

命名空間:

Microsoft.Extensions.Caching.Distributed

組件:

Microsoft.Extensions.Caching.Abstractions.dll

套件:

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

來源:

DistributedCacheExtensions.cs

使用指定的索引鍵，以異步方式設定指定快取中的位元組序列。

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

static member SetAsync : Microsoft.Extensions.Caching.Distributed.IDistributedCache * string * byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task

<Extension()>
Public Function SetAsync (cache As IDistributedCache, key As String, value As Byte(), Optional token As CancellationToken = Nothing) As Task

參數

cache

IDistributedCache

要在其中儲存數據的快取。

key

String

要儲存數據的索引鍵。

value

Byte[]

要儲存在快取中的數據。

token

CancellationToken

自選。 要取消作業的 CancellationToken。

傳回

Task

表示異步設定作業的工作。

例外狀況

OperationCanceledException

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

ArgumentNullException

key 或 value 為 null。

備註

這個方法會儲存在工作中，它會傳回方法同步對應項可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException，仍會同步擲回。 如需預存的例外狀況，請參閱 Set(IDistributedCache, String, Byte[])擲回的例外狀況。