DistributedCacheExtensions.SetStringAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
SetStringAsync(IDistributedCache, String, String, CancellationToken) |
使用指定的索引鍵,以異步方式在指定的快取中設定字串。 |
SetStringAsync(IDistributedCache, String, String, DistributedCacheEntryOptions, CancellationToken) |
使用指定的索引鍵,以異步方式在指定的快取中設定字串。 |
SetStringAsync(IDistributedCache, String, String, CancellationToken)
使用指定的索引鍵,以異步方式在指定的快取中設定字串。
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。
傳回
表示異步設定作業的工作。
例外狀況
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
key
或 value
為 null。
備註
這個方法會儲存在工作中,它會傳回方法同步對應項可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException,仍會同步擲回。 如需預存的例外狀況,請參閱 SetString(IDistributedCache, String, String)擲回的例外狀況。
適用於
SetStringAsync(IDistributedCache, String, String, DistributedCacheEntryOptions, CancellationToken)
使用指定的索引鍵,以異步方式在指定的快取中設定字串。
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。
傳回
表示異步設定作業的工作。
例外狀況
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
key
或 value
為 null。
備註
這個方法會儲存在工作中,它會傳回方法同步對應項可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException,仍會同步擲回。 如需預存的例外狀況,請參閱 SetString(IDistributedCache, String, String, DistributedCacheEntryOptions)擲回的例外狀況。