工坊手册

主题

DataStoreRemoveVersionOptions ​

DataStoreRemoveVersionOptions 是 DataStore:RemoveVersionAsync 的可选参数容器，可通过 DataStoreRemoveVersionOptions.New() 创建。

概览 ​

DataStoreRemoveVersionOptions 是 DataStore:RemoveVersionAsync 的可选参数容器，可通过 DataStoreRemoveVersionOptions.New() 创建。

可通过 DataStoreRemoveVersionOptions.New() 构造

代码示例 ​

使用 options 删除指定版本

lua
-- @runtime server
local DataStoreService = game:GetService('DataStoreService')
local Task = game:GetService('Task')
local dataStore = DataStoreService:GetDataStore('DocumentationSandbox')
local key = 'cleanup_demo'
local options = DataStoreRemoveVersionOptions.New()
options.WithKeyInfo = true

Task:Spawn(function()
    local pages = dataStore:ListVersionsAsync(key, false, 0, 0, 10)
    local versionInfo = pages:GetCurrentPage()[1]
    if versionInfo == nil then
        print('当前键没有可删除的历史版本')
        return
    end
    -- 仅在确认该沙盒版本可以删除后执行
    local removedValue, keyInfo = dataStore:RemoveVersionAsync(key, versionInfo.Version, options)
    print('删除的版本数据:', removedValue, '版本:', keyInfo and keyInfo.Version)
end)

属性 ​

名称类型默认值说明
WithKeyInfoBool-是否在移除版本时返回包含版本号、创建和修改日期、UserIds 和 Metas 的 DataStoreKeyInfo 实例。