OrderedDataStore
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Un OrderedDataStore è essenzialmente un GlobalDataStore con l'eccezione che i valori memorizzati devono essere interi positivi. Esso esplica un metodo 2> Class.OrderedDataStore:GetSortedAsync()|GetSortedAsync()2> che consente l'ispezione delle entrate in ordine casuale utilizzando un oggetto
I negozi di dati ordinati non supportano la versionizzazione e i metadati, quindi DataStoreKeyInfo è sempre nil per le chiavi in un OrderedDataStore . Se hai bisogno di Assistenzala versionizzazione e i metadati, usa un 1> Class.DataStore1> .
I negozi di dati ordinati non supportano il parametro opzionale userIds per SetAsync() o IncrementAsync() .
Vedi Archivi di dati per un'analisi sui server di archiviazione dei dati.
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
Restituisce un oggetto DataStorePages .
Restituisce il valore di una chiave in un determinato store di dati e un'esempioDataStoreKeyInfo .
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Aumenta il valore di una chiave di un importo fornito (entrambi devono essere interi).
Rimuove la chiave specificata mentre conserva anche una versione accessibile.
Imposta il valore del data store per la chiave specificata.
Aggiorna il valore di una chiave con un nuovo valore dalla funzione richiamata specificata.
Proprietà
Metodi
GetSortedAsync
Restituisce un oggetto DataStorePages. L'ordine di sorta è determinato da ascending, la lunghezza di ciascuna pagina da pageSize e 2> minValue2> / 5> maxValue5> sono parametri opzionali che filtrano i risultati.
Vedi Data Stores per limiti di richiesta e descrizioni degli errori.
Parametri
Un bool che indica se le pagine dei dati restituiti sono in ordine crescente.
La lunghezza di ciascuna 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 maggiore di maxValue saranno escluse.
Restituzioni
Un oggetto DataStorePages ordinato in base agli argomenti forniti.