OrderedDataStore
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Ein OrderedDataStore ist im Grunde ein Class.GlobalDataStore mit der Ausnahme, dass gespeicherte Werte 2> positive Inhalte2> sein müssen. Es zeigt einen Methoden 5> Class.OrderedDataStore:GetSortedAsync()|GetSortedAsync() , der die Einträge in sortierter Reihenfolge mit einem 8> Class.DataStorePages
Bestellte Daten-Stores unterstützen keine Versionierung und Metadaten, so dass DataStoreKeyInfo immer nil für Schlüssel in einem OrderedDataStore ist. Wenn Sie Versionierung und Supportbenötigen, verwenden Sie einen 1> Class.DataStore1>.
Bestellte Daten-Stores unterstützen nicht den optionalen userIds -Parameter für SetAsync() oder IncrementAsync().
Siehe Datenspeicher für eine Übersicht über die Verwendung von bestellten Daten-Stores.
Code-Beispiele
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()Zusammenfassung
Methoden
Kehrt ein DataStorePages Objekt zurück.
Kehre den Wert eines Schlüssels in einem bestimmten Daten-Store und einer DataStoreKeyInfo Instanz zurück.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Erhöht den Wert eines Schlüssels um die angegebene Menge (beide müssen Zahlen sein).
Entfernt den angegebenen Schlüssel, während eine zugängliche Version beibehalten wird.
Setzt den Wert des Datenspeichers für den angegebenen Schlüssel.
Aktualisiert den Wert eines Schlüssels mit einem neuen Wert aus der angegebenen Rückruffunktion.
Eigenschaften
Methoden
GetSortedAsync
Gibt ein DataStorePages-Objekt zurück. Die Sortierung erfolgt nach aufsteigender und die Länge jedes Seiten nach pageSize und 2> minValue2> / 5> maxValue5> . Dies sind optionale Filter, die die Ergebnisse filtern.
Siehe Datenspeicherplätze für Anfragegrenzen und Beschreibungen der Fehlercodes.
Parameter
EinBoolean, der anzeigt, ob die zurückgegebenen Datenseiten in aufsteigender Reihenfolge sind.
Die Länge jedes Seiten. Standardmäßig ist 50. Der maximale erlaubte Wert ist 100.
festlegenmit einem Wert weniger als minValue 将被排除。
festlegenmit einem Wert größer als maxValue 将被排除。
Rückgaben
Ein sortiertes DataStorePages -Objekt basierend auf den bereitgestellten Argumenten.