AppendKey 方法

AppendKeyAsync 方法

ChangePassword 方法

ChangePasswordAsync 方法

DBSize 方法

DeleteHashKeyAsync 方法

DeleteKey 方法

DeleteKeyAsync 方法

ExistsHashKey 方法

ExistsHashKeyAsync 方法

GetListLengthAsync 方法

IncrementHashKey 方法

IncrementHashKeyAsync 方法

IncrementKey 方法

IncrementKeyAsync 方法

ListInsertAfter 方法

ListInsertAfterAsync 方法

ListInsertBefore 方法

ListInsertBeforeAsync 方法

ListLeftPushXAsync 方法

ListRange 方法

ListRangeAsync 方法

ListRemoveElementMatch 方法

ListRemoveElementMatchAsync 方法

ListRightPop 方法

ListRightPopAsync 方法

ListRightPopLeftPush 方法

ListRightPopLeftPushAsync 方法

ListRightPush 方法

ListRightPushAsync 方法

ListRightPushX 方法

ListRightPushXAsync 方法

ReadAndWriteKeyAsync 方法

ReadAsync(T) 方法

ReadHashKey 方法

ReadHashKeyAll 方法

ReadHashKeyAllAsync 方法

ReadHashKeyAsync 方法

ReadHashKeyLength 方法

ReadHashKeyLengthAsync 方法

ReadHashKeys 方法

ReadHashKeysAsync 方法

ReadHashValues 方法

ReadHashValuesAsync 方法

ReadKey 方法

ReadKeyAsync 方法

ReadKeyLength 方法

ReadKeyLengthAsync 方法

ReadListByIndexAsync 方法

ReadRandomKey 方法

ReadRandomKeyAsync 方法

ReadServerTime 方法

ReadServerTimeAsync 方法

SetInterStoreAsync 方法

SetRandomMemberAsync 方法

SetUnionStoreAsync 方法

ToString 方法

Write(T) 方法

WriteAndPublishKey 方法

WriteAndPublishKeyAsync 方法

WriteAsync(T) 方法

WriteExpireKey 方法

WriteExpireKeyAsync 方法

WriteHashKey 方法

WriteHashKeyAsync 方法

WriteHashKeyNx 方法

WriteHashKeyNxAsync 方法

WriteKey 方法

WriteKeyAsync 方法

WriteKeyIfNotExists 方法

WriteKeyIfNotExistsAsync 方法

WriteKeyRange 方法

WriteKeyRangeAsync 方法

ZSetIncreaseByAsync 方法

ZSetRange 方法

ZSetRangeAsync 方法

ZSetRangeByScore 方法

ZSetRangeByScoreAsync 方法

ZSetRemoveRangeByRank 方法

ZSetRemoveRangeByRankAsync 方法

ZSetRemoveRangeByScore 方法

ZSetRemoveRangeByScoreAsync 方法

ZSetReverseRange 方法

ZSetReverseRangeAsync 方法

ZSetReverseRangeByScore 方法

ZSetReverseRangeByScoreAsync 方法

ZSetReverseRank 方法

ZSetReverseRankAsync 方法

ZSetScore 方法

ZSetScoreAsync 方法

RedisClientPoolExpireKeyAsync 方法

为给定 key 设置生存时间，当 key 过期时(生存时间为 0 )，它会被自动删除。设置成功返回 1 。当 key 不存在或者不能为 key 设置生存时间时，返回 0 。

命名空间： HslCommunication.Enthernet.Redis
程序集： HslCommunication (在 HslCommunication.dll 中) 版本：12.1.2.0 (12.1.2.0)

语法

C++

复制

public Task<OperateResult<int>> ExpireKeyAsync(
	string key,
	int seconds
)

Public Function ExpireKeyAsync ( 
	key As String,
	seconds As Integer
) As Task(Of OperateResult(Of Integer))

public:
Task<OperateResult<int>^>^ ExpireKeyAsync(
	String^ key, 
	int seconds
)

member ExpireKeyAsync : 
        key : string * 
        seconds : int -> Task<OperateResult<int>>

参数

key: 类型：SystemString
关键字
seconds: 类型：SystemInt32
当前key的生存时间，单位为秒

返回值

类型：TaskOperateResultInt32
设置成功返回 1 。当 key 不存在或者不能为 key 设置生存时间时，返回 0 。

备注

在 Redis 中，带有生存时间的 key 被称为『易失的』(volatile)。
生存时间可以通过使用 DEL 命令来删除整个 key 来移除，或者被 SET 和 GETSET 命令覆写( overwrite)，这意味着，如果一个命令只是修改( alter)一个带生存时间的 key 的值而不是用一个新的 key 值来代替( replace)它的话，那么生存时间不会被改变。
比如说，对一个 key 执行 INCR 命令，对一个列表进行 LPUSH 命令，或者对一个哈希表执行 HSET 命令，这类操作都不会修改 key 本身的生存时间。
另一方面，如果使用 RENAME 对一个 key 进行改名，那么改名后的 key 的生存时间和改名前一样。
RENAME 命令的另一种可能是，尝试将一个带生存时间的 key 改名成另一个带生存时间的 another_key ，这时旧的 another_key( 以及它的生存时间)会被删除，然后旧的 key 会改名为 another_key ，因此，新的 another_key 的生存时间也和原本的 key 一样。
使用 PERSIST 命令可以在不删除 key 的情况下，移除 key 的生存时间，让 key 重新成为一个『持久的』(persistent) key 。
更新生存时间
可以对一个已经带有生存时间的 key 执行 EXPIRE 命令，新指定的生存时间会取代旧的生存时间。
过期时间的精确度
在 Redis 2.4 版本中，过期时间的延迟在 1 秒钟之内 —— 也即是，就算 key 已经过期，但它还是可能在过期之后一秒钟之内被访问到，而在新的 Redis 2.6 版本中，延迟被降低到 1 毫秒之内。
Redis 2.1.3 之前的不同之处
在 Redis 2.1.3 之前的版本中，修改一个带有生存时间的 key 会导致整个 key 被删除，这一行为是受当时复制( replication)层的限制而作出的，现在这一限制已经被修复。

参见

引用

RedisClientPool 类

HslCommunication.Enthernet.Redis 命名空间

RedisClientPoolAddLanguageSpecificTextSet("LST6D2CB74A_0?cpp=::|nu=.");ExpireKeyAsync 方法

参数

返回值

引用

RedisClientPoolExpireKeyAsync 方法