DistributedCacheExtensions.SetStringAsync 方法

定義

命名空間:

Microsoft.Extensions.Caching.Distributed

組件:

Microsoft.Extensions.Caching.Abstractions.dll

套件:

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

多載

SetStringAsync(IDistributedCache, String, String, CancellationToken)	以非同步方式，使用指定的索引鍵，在指定的快取中設定字串。
SetStringAsync(IDistributedCache, String, String, DistributedCacheEntryOptions, CancellationToken)	以非同步方式，使用指定的索引鍵，在指定的快取中設定字串。

SetStringAsync(IDistributedCache, String, String, CancellationToken)

來源:

DistributedCacheExtensions.cs

以非同步方式，使用指定的索引鍵，在指定的快取中設定字串。

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

參數

cache

IDistributedCache

資料儲存所在的快取。

key

String

儲存資料的索引鍵。

value

String

要儲存在快取中的資料。

token

CancellationToken

選擇性。 取消作業的 CancellationToken。

傳回

Task

表示非同步設定作業的工作。

例外狀況

ArgumentNullException

key 或 value 為 null。

OperationCanceledException

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

備註

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

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

來源:

DistributedCacheExtensions.cs

以非同步方式，使用指定的索引鍵，在指定的快取中設定字串。

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

參數

cache

IDistributedCache

資料儲存所在的快取。

key

String

儲存資料的索引鍵。

value

String

要儲存在快取中的資料。

options

DistributedCacheEntryOptions

項目的快取選項。

token

CancellationToken

選擇性。 取消作業的 CancellationToken。

傳回

Task

表示非同步設定作業的工作。

例外狀況

ArgumentNullException

key 或 value 為 null。

OperationCanceledException

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

備註

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