OrderedDataStore
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
Un OrderedDataStore es esencialmente un GlobalDataStore con la excepción de que los valores almacenados deben ser valores positivos . Explica un método 1> Class.OrderedDataStore:GetSortedAsync()|GetSortedAsync()1> que permite inspeccionar las entradas en orden al usar un objeto
Los almacenes de datos ordenados no admiten versiones y metadatos, por lo que DataStoreKeyInfo siempre es nil para las llaves en un OrderedDataStore. Si necesitas Soportepara versiones y metadatos, usa un 2>Class.DataStore2>.
Los almacenes de datos ordenados no admiten el parámetro opcional userIds para SetAsync() o IncrementAsync() .
Vea Almacenamiento de datos para obtener una vista general de cómo utilizar almacenamientos de datos ordenados.
Muestras de código
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()Resumen
Métodos
Regresa un objeto DataStorePages .
Devuelve el valor de una llave en un almacén de datos especificado y una instancia DataStoreKeyInfo
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Aumenta el valor de una llave en la cantidad proporcionada (ambos deben ser números enteros).
Elimina la llave especificada mientras también se mantiene una versión accesible.
Establece el valor del almacén de datos para la clave proporcionada.
Actualiza el valor de una clavecon un nuevo valor de la función de llamada especificada.
Propiedades
Métodos
GetSortedAsync
Devuelve un objeto DataStorePages. El orden de clasificación se determina por ascender, la longitud de cada página por pageSize y 2> minValue2> / 5> maxValue5> son parámetros opcionales que filtran los resultados.
Véase almacén de datos para los límites de solicitudes y descripciones de los códigos de error.
Parámetros
Un valor deBooleano que indica si las páginas de datos devueltos están en orden ascendente.
La longitud de cada página. Por defecto es 50. El valor máximo permitido es 100.
Parámetro opcional. Si se establecer, las páginas de datos con un valor menor que minValue se excluirán.
Parámetro opcional. Si se establecer, las páginas de datos con un valor mayor que maxValue se excluirán.
Devuelve
Un objeto DataStorePages clasificado según los argumentos proporcionados.