OrderedDataStore
*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.
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.
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
Zwraca obiekt DataStorePages .
Zwraca wartość klucza w określonym przechowywaniu danych i instancję DataStoreKeyInfo.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Zwiększa wartość klucza o podanych liczbie (obie muszą być liczbami całkowitymi).
Usuwa określony klucz, zachowując jednocześnie dostępną wersję.
Ustawia wartość magazynu danych dla podanego klucza.
Aktualizuje wartość klucza z nową wartością z określonej funkcji zwrotnej.
Właściwości
Metody
GetSortedAsync
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
Boolean wskazujący, czy zwrócone strony danych są w rosnącej kolejności.
Długość każdej strony. Domyślnie jest 50. Maksymalna wartość pozwala na 100.
Opcjonalny parametr. Jeśli ustawiać, strony danych z wartością mniejszą niż minValue zostaną wykluczone.
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.