OrderedDataStore
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Un OrdinatedDataStore è essenzialmente un GlobalDataStore con l'eccezione che i valori memorizzati devono essere interi positivi .Esso espone un metodo GetSortedAsync() che consente l'ispezione delle voci in ordine ordinato utilizzando un oggetto DataStorePages.
Gli store di dati ordinati non supportano la versioning e i metadati, quindi DataStoreKeyInfo è sempre nil per le chiavi in un OrderedDataStore .Se hai bisogno di Assistenzaper la versionazione e i metadati, usa un DataStore .
I negozi di dati ordinati non supportano il parametro opzionale userIds per SetAsync() o IncrementAsync().
Vedi Magazzini di dati per una panoramica sull'utilizzo dei magazzini di dati ordinati.
Campioni di codice
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()Sommario
Proprietà
Metodi
- GetSortedAsync(ascending : boolean,pagesize : number,minValue : Variant,maxValue : Variant):DataStorePages
Restituisce un oggetto DataStorePages .
Restituisce il valore di una chiave in un data store specificato e un'esempioDataStoreKeyInfo .
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Aumenta il valore di una chiave dell'importo fornito (entrambi devono essere interi).
Rimuove la chiave specificata mentre mantiene anche una versione accessibile.
Imposta il valore del deposito dati per la chiave data.
Aggiorna il valore di una chiave con un nuovo valore dalla funzione callback specificata.
Proprietà
Metodi
GetSortedAsync
Restituisce un oggetto DataStorePages .L'ordine di selezione è determinato da ascendente , la lunghezza di ogni pagina da pageSize , e minValue / maxValue sono parametri opzionali che filtrano i risultati.
Vedi Magazzini di dati per i limiti delle richieste e le descrizioni dei codici di errore.
Parametri
Un booleano che indica se le pagine dei dati restituiti sono in ordine crescente.
La lunghezza di ogni pagina. Per impostazione predefinita è 50. Il valore massimo consentito è 100.
Parametro opzionale. Se Impostare, le pagine dei dati con un valore inferiore a minValue saranno escluse.
Parametro opzionale. Se Impostare, le pagine dei dati con un valore superiore a maxValue saranno escluse.
Restituzioni
Un oggetto ordinato DataStorePages in base agli argomenti forniti.