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

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

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