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)

Source:
DistributedCacheExtensions.cs
Source:
DistributedCacheExtensions.cs
Source:
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)

Source:
DistributedCacheExtensions.cs
Source:
DistributedCacheExtensions.cs
Source:
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)异常。

适用于