OrderedDataStore
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Ein Ordonnungsdatenspeicher ist im Wesentlichen ein GlobalDataStore mit der Ausnahme, dass gespeicherte Werte positiv sein müssen positive Zahlen .Es zeigt eine Methode GetSortedAsync(), die die Überprüfung der Einträge in sortierter Reihenfolge mit einem DataStorePages Objekt ermöglicht.
Sortierte Datenlagern unterstützen keine Versionskontrolle und Metadaten, so ist DataStoreKeyInfo immer nil für Schlüssel in einem OrderedDataStore .Wenn Sie Versionierung und Supportbenötigen, verwenden Sie ein DataStore.
Sortierte Datenspeicher unterstützen den optionalen userIds-Parameter für SetAsync() oder IncrementAsync() nicht.
Siehe Datenspeicher für einen Überblick über die Verwendung von bestellten Datenlagern.
Code-Beispiele
This code sample demonstrates usage of an OrderedDataStore and pages.
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
- GetSortedAsync(ascending : boolean,pagesize : number,minValue : Variant,maxValue : Variant):DataStorePages
Gibt ein DataStorePages.
Gibt den Wert eines Schlüssels in einem bestimmten Datenlagers und einer DataStoreKeyInfo Instanz zurück.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Erhöht den Wert eines Schlüssels um den angegebenen Betrag (beide müssen Zahlen sein).
Entfernt den angegebenen Schlüssel, während eine zugängliche Version beibehalten wird.
Legt den Wert des Datenspeichers für den angegebenen Schlüssel fest.
Aktualisiert den Wert eines Schlüssels mit einem neuen Wert aus der angegebenen Rückruffunktion.
Eigenschaften
Methoden
GetSortedAsync
Gibt ein DataStorePages.Die Sortierreihenfolge wird durch steigend bestimmt, die Länge jeder Seite durch Seitengröße und minValue / maxValue sind optionale Parameter, die die Ergebnisse filtern.
Siehe Datenspeicher für Anforderungslimits und Beschreibungen der Fehlercodes.
Parameter
Ein boolescher Indikator, der anzeigt, ob die zurückgegebenen Datenblätter in aufsteigender Reihenfolge sind.
Die Länge jeder Seite. Standardmäßig ist es 50. Der maximale zulässige Wert beträgt 100.
Optioneller Parameter. Wenn er festlegenist, werden Datenblätter mit einem Wert weniger als minValue ausgeschlossen.
Optioneller Parameter. Wenn er festlegenist, werden Datenblätter mit einem Wert größer als maxValue ausgeschlossen.
Rückgaben
Ein sortiertes DataStorePages Objekt, basierend auf den bereitgestellten Argumenten.