OrderedDataStore

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Não criável
Não replicado

Um Armazenamento de Dados Ordenado é basicamente um GlobalDataStore com a exceção de que os valores armazenados devem ser inteiros positivos. Ele exibe um método 2> Class.OrderedDataStore:GetSortedAsync()|GetSortedAsync()2> que permite a inspeção das entradas em ordem usando um Objeto<

Armazenamento de dados ordenado não suporta versão e metadados, então DataStoreKeyInfo sempre é nil para chaves em um OrderedDataStore. Se você precisar de versão e metadados, use um 2> Class.DataStore2>.

Armazenamento de dados ordenados não suporta o parâmetro opcional userIds para SetAsync() ou IncrementAsync().

Veja Armazenamento de Dados para uma visão geral de como usar armazenamentos de dados ordenados.

Amostras de código

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()

Resumo

Métodos

Métodos herdados de GlobalDataStore

Propriedades

Métodos

GetSortedAsync

Rendimentos

Retorna um ObjetoDataStorePages. A ordem de classificação é determinada por subir, a longitude de cada página por pageSize e 2> minValue2> / 5> maxValue5> são parâmetros opcionais que filtram os resultados.

Veja Armazenamento de Dados para limites de solicitação e descrições dos códigos de erro.

Parâmetros

ascending: bool

Um boolo indicando se as páginas de dados retornadas estão em ordem crescente.

pagesize: number

A longura de cada página. Por padrão, é 50. O valor máximo permitido é 100.

minValue: Variant

Parâmetro opcional. Se for configurar, páginas de dados com um valor menor que minValue serão excluídas.

maxValue: Variant

Parâmetro opcional. Se configurar, páginas de dados com um valor maior que maxValue serão excluídas.


Devolução

Um objeto DataStorePages classificado com base nos argumentos fornecidos.

Eventos