OrderedDataStore

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Création impossible
Non répliqué

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.

OrderedDataStore Basics

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

Méthodes hérités de GlobalDataStore

Propriétés

Méthodes

GetSortedAsync

Rendement

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

ascending: boolean

Un booléen indiquant si les pages de données retournées sont dans l'ordre croissant.

Valeur par défaut : ""
pagesize: number

La longueur de chaque page. Par défaut, c'est 50. La valeur maximale autorisée est 100.

Valeur par défaut : ""
minValue: Variant

Paramètre facultatif. Si configurerle définissez, les pages de données avec une valeur inférieure à minValue seront exclues.

Valeur par défaut : ""
maxValue: Variant

Paramètre facultatif. Si configurerle définissez, les pages de données avec une valeur supérieure à maxValue seront exclues.

Valeur par défaut : ""

Retours

Un objet trié DataStorePages basé sur les arguments fournis.

Évènements