OrderedDataStore
*此內容很快就會推出您所選的語言版本。
A OrderedDataStore is essentially a GlobalDataStore with the exception that stored values must be positive integers. It exposes a method GetSortedAsync() which allows inspection of the entries in sorted order using a DataStorePages object.
Ordered data stores do not support versioning and metadata, so DataStoreKeyInfo is always nil for keys in an OrderedDataStore. If you need versioning and metadata support, use a DataStore.
Ordered data stores do not support the optional userIds parameter for SetAsync() or IncrementAsync().
See Data Stores for an overview on using ordered data stores.
範例程式碼
local DataStoreService = game:GetService("DataStoreService")
local pointsStore = DataStoreService:GetOrderedDataStore("Points")
local function printTopTenPlayers()
local isAscending = false
local pageSize = 10
local pages = pointsStore:GetSortedAsync(isAscending, pageSize)
local topTen = pages:GetCurrentPage()
-- The data in 'topTen' is stored with the index being the index on the page
-- For each item, 'data.key' is the key in the OrderedDataStore and 'data.value' is the value
for rank, data in ipairs(topTen) do
local name = data.key
local points = data.value
print(name .. " is ranked #" .. rank .. " with " .. points .. "points")
end
-- Potentially load the next page...
--pages:AdvanceToNextPageAsync()
end
-- Create some data
pointsStore:SetAsync("Alex", 55)
pointsStore:SetAsync("Charley", 32)
pointsStore:SetAsync("Sydney", 68)
-- Display the top ten players
printTopTenPlayers()概要
方法
Returns a DataStorePages object.
返回指定資料存取中的鑰匙值，並且是 DataStoreKeyInfo 個實個體、實例。
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
增加鑰匙的值提供的數量（必須是整數）。
保留可用版本，同時移除指定的鑰匙。
設定資料存取對應的鑰鍵的數據存取值。
更新鑰鍵的值，以從指定的回撥函數中的新值。
屬性
方法
GetSortedAsync
Returns a DataStorePages object. The sort order is determined by ascending, the length of each page by pageSize, and minValue/maxValue are optional parameters which filter the results.
See Data Stores for request limits and descriptions of the error codes.
參數
A boolean indicating whether the returned data pages are in ascending order.
The length of each page. By default is 50. The max allowed value is 100.
Optional parameter. If set, data pages with a value less than minValue will be excluded.
Optional parameter. If set, data pages with a value greater than maxValue will be excluded.
返回
A sorted DataStorePages object based on the provided arguments.