閱讀英文

共用方式為


DistributedCacheExtensions.SetStringAsync 方法

定義

多載

SetStringAsync(IDistributedCache, String, String, CancellationToken)

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

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

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

SetStringAsync(IDistributedCache, String, String, CancellationToken)

來源:
DistributedCacheExtensions.cs
來源:
DistributedCacheExtensions.cs
來源:
DistributedCacheExtensions.cs
來源:
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);

參數

cache
IDistributedCache

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

key
String

要儲存數據的索引鍵。

value
String

要儲存在快取中的數據。

token
CancellationToken

自選。 要取消作業的 CancellationToken

傳回

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

例外狀況

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

keyvalue 為 null。

備註

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

適用於

.NET 9 及其他版本
產品 版本
.NET 6, 7, 8, 9
.NET Framework 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0

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

來源:
DistributedCacheExtensions.cs
來源:
DistributedCacheExtensions.cs
來源:
DistributedCacheExtensions.cs
來源:
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);

參數

cache
IDistributedCache

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

key
String

要儲存數據的索引鍵。

value
String

要儲存在快取中的數據。

options
DistributedCacheEntryOptions

專案的快取選項。

token
CancellationToken

自選。 要取消作業的 CancellationToken

傳回

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

例外狀況

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

keyvalue 為 null。

備註

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

適用於

.NET 9 及其他版本
產品 版本
.NET 6, 7, 8, 9
.NET Framework 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0