OrderedDataStore

Pokaż przestarzałe

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Brak możliwości tworzenia
Bez replikacji

A OrderedDataStore jest zasadniczo GlobalDataStore z wyjątkiem tego, że przechowywane wartości muszą być pozytywne liczby. Wyświetla metodę 2> Class.OrderedDataStore:GetSortedAsync()|GetSortedAsync()2>, która umożliwia inspekcję wpisów w sort

Przechowywane dane nie wspierają wersji i metadanych, więc DataStoreKeyInfo zawsze jest nil dla kluczy w OrderedDataStore. Jeśli potrzebujesz wsparcia dla wersji i metadanych, użyj 2>Class.DataStore2>.

Przechowywane dane nie wspierają opcjonalnego parametru userIds dla SetAsync() lub IncrementAsync().

Zobacz magazyny danych dla ogólnego przeglądu użycia przechowywanych danych.

Przykłady kodu

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

Podsumowanie

Metody

Metody odziedziczeni z: GlobalDataStore

Właściwości

Metody

GetSortedAsync

Wynik

Zwraca obiekt DataStorePages. Porządek sortowania jest określony przez wzrost , długość każdej strony przez pageSize i 1> minValue1> / 4> maxValue4> są opcjonalnymi parami, które filtrowują wyniki.

Zobacz magazyny danych dla limitów wniosków i opisów kodów błędu.

Parametry

ascending: bool

Boolean wskazujący, czy zwrócone strony danych są w rosnącej kolejności.

pagesize: number

Długość każdej strony. Domyślnie jest 50. Maksymalna wartość pozwala na 100.

minValue: Variant

Opcjonalny parametr. Jeśli ustawiać, strony danych z wartością mniejszą niż minValue zostaną wykluczone.

maxValue: Variant

Opcjonalny parametr. Jeśli ustawiać, strony danych z wartością większą niż maxValue zostaną wykluczone.


Zwroty

Sortowany obiekt DataStorePages na podstawie dostarczonych argumentów.

Zdarzenia