DistributedCacheExtensions.SetStringAsync 方法

  • 參考

定義

命名空間:
Microsoft.Extensions.Caching.Distributed
組件:
Microsoft.Extensions.Caching.Abstractions.dll
套件:
Microsoft.Extensions.Caching.Abstractions v6.0.0
套件:
Microsoft.Extensions.Caching.Abstractions v7.0.0
套件:
Microsoft.Extensions.Caching.Abstractions v8.0.0
套件:
Microsoft.Extensions.Caching.Abstractions v9.0.0-preview.2.24128.5

多載

SetStringAsync(IDistributedCache, String, String)

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

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

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

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

SetStringAsync(IDistributedCache, String, String)

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

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ SetStringAsync(Microsoft::Extensions::Caching::Distributed::IDistributedCache ^ cache, System::String ^ key, System::String ^ value);
public static System.Threading.Tasks.Task SetStringAsync (this Microsoft.Extensions.Caching.Distributed.IDistributedCache cache, string key, string value);
static member SetStringAsync : Microsoft.Extensions.Caching.Distributed.IDistributedCache * string * string -> System.Threading.Tasks.Task
<Extension()>
Public Function SetStringAsync (cache As IDistributedCache, key As String, value As String) As Task

參數

cache
IDistributedCache

資料儲存所在的快取。

key
String

儲存資料的索引鍵。

value
String

要儲存在快取中的資料。

傳回

Task

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

例外狀況

ArgumentNullException

key 或 value 為 null。

備註

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

適用於

SetStringAsync(IDistributedCache, String, String, DistributedCacheEntryOptions)

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

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ SetStringAsync(Microsoft::Extensions::Caching::Distributed::IDistributedCache ^ cache, System::String ^ key, System::String ^ value, Microsoft::Extensions::Caching::Distributed::DistributedCacheEntryOptions ^ options);
public static System.Threading.Tasks.Task SetStringAsync (this Microsoft.Extensions.Caching.Distributed.IDistributedCache cache, string key, string value, Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions options);
static member SetStringAsync : Microsoft.Extensions.Caching.Distributed.IDistributedCache * string * string * Microsoft.Extensions.Caching.Distributed.DistributedCacheEntryOptions -> System.Threading.Tasks.Task
<Extension()>
Public Function SetStringAsync (cache As IDistributedCache, key As String, value As String, options As DistributedCacheEntryOptions) As Task

參數

cache
IDistributedCache

資料儲存所在的快取。

key
String

儲存資料的索引鍵。

value
String

要儲存在快取中的資料。

options
DistributedCacheEntryOptions

項目的快取選項。

傳回

Task

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

例外狀況

ArgumentNullException

key 或 value 為 null。

備註

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

適用於

SetStringAsync(IDistributedCache, String, String, CancellationToken)

來源:
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);
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
來源:
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);
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)擲回的例外狀況。

適用於