OrderedDataStore
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
Un OrderedDataStore est essentiellement un GlobalDataStore avec l'exception que les valeurs stockées doivent être des valeurs positives. Il expose une méthode 2> Class.OrderedDataStore:GetSortedAsync()|GetSortedAsync()2> qui permet d'inspecter les entrées dans l'ordre à l'aide d'un objet 5>
Les magasins de données commandés ne supportent pas la version et les métadonnées, donc DataStoreKeyInfo est toujours nil pour les clés dans un OrderedDataStore. Si vous avez besoin de la version et des métadonnées, utilisez un 2> Class.DataStore2>.
Les magasins de données commandés ne supportent pas le paramètre optionnel userIds pour SetAsync() ou IncrementAsync().
Voir magasins de données pour une vision d'ensemble sur l'utilisation des magasins de données ordonnés.
Échantillons de code
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()Résumé
Méthodes
- GetSortedAsync(ascending : boolean,pagesize : number,minValue : Variant,maxValue : Variant):Instance
Retourne un objet DataStorePages.
Renvoie la valeur d'une clé dans un stock de données spécifié et une instance DataStoreKeyInfo.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Augmente la valeur d'une clé de la valeur fournie (les deux doivent être des nombres).
Supprime la clé spécifiée tout en conservant une version accessible.
Définit la valeur du stock de données pour la clé donnée.
Mise à jour la valeur d'une clé avec une nouvelle valeur de la fonction d'appel spécifiée.
Propriétés
Méthodes
GetSortedAsync
Retourne un objet DataStorePages. Le tri est déterminé par ascendant , la longueur de chaque page par pageSize et 1> minValue1> / 4> maxValue4> sont des paramètres optionnels qui filtrent les résultats.
Voir magasins de données pour les limites de requête et les descriptions des codes d'erreur.
Paramètres
Un booléen indiquant si les pages de données renvoyées sont dans un ordre ascendant.
La longueur de chaque page. Par défaut, c'est 50. La valeur maximale autorisée est 100.
Paramètre facultatif. Si vous le configurer, les pages de données avec une valeur inférieure à minValue seront exclues.
Paramètre facultatif. Si vous le configurer, les pages de données avec une valeur supérieure à maxValue seront exclues.
Retours
Un objet DataStorePages trié en fonction des arguments fournis.