OrderedDataStore
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
Un magasin de données ordonné est essentiellement un GlobalDataStore avec l'exception que les valeurs stockées doivent être des entiers positifs .Il expose une méthode GetSortedAsync() qui permet d'inspecter les entrées dans l'ordre trié en utilisant un objet DataStorePages.
Les magasins de données ordonné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 assistancede version et de métadonnées, utilisez un DataStore .
Les magasins de données ordonnés ne supportent pas le paramètre facultatif userIds pour SetAsync() ou IncrementAsync().
Voir magasins de données pour une vue d'ensemble sur l'utilisation des magasins de données ordonnés.
Échantillons de code
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()
Résumé
Méthodes
- GetSortedAsync(ascending : boolean,pagesize : number,minValue : Variant,maxValue : Variant):DataStorePages
Retourne un objet DataStorePages .
Renvoie la valeur d'une clé dans un magasin 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 quantité fournie (les deux doivent être des entiers).
Supprime la clé spécifiée tout en conservant une version accessible.
Définit la valeur du magasin de données pour la clé donnée.
Mise à jour de 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 .L'ordre de tri est déterminé par ascendant , la longueur de chaque page par pageSize et minValue / maxValue sont des paramètres facultatifs qui filtrent les résultats.
Voir magasins de données pour les limites de demande et les descriptions des codes d'erreur.
Paramètres
Un booléen indiquant si les pages de données retournées sont dans l'ordre croissant.
La longueur de chaque page. Par défaut, c'est 50. La valeur maximale autorisée est 100.
Paramètre facultatif. Si configurerle définissez, les pages de données avec une valeur inférieure à minValue seront exclues.
Paramètre facultatif. Si configurerle définissez, les pages de données avec une valeur supérieure à maxValue seront exclues.
Retours
Un objet trié DataStorePages basé sur les arguments fournis.