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

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

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