OrderedDataStore

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Tidak Dapat Dibuat
Tidak Direplikasi

A OrderedDataStore pada dasarnya adalah GlobalDataStore dengan pengecualian bahwa nilai yang disimpan harus menjadi bilangan positif .Ini mengekspos metode GetSortedAsync() yang memungkinkan pemeriksaan entri dalam urutan terurut menggunakan objek DataStorePages.

Toko data yang diurutkan tidak mendukung versi dan metadata, jadi DataStoreKeyInfo selalu nil untuk kunci di dalam OrderedDataStore .Jika Anda membutuhkan dukungan versi dan metadata, gunakan DataStore .

Toko data yang diurutkan tidak mendukung parameter opsional userIds untuk SetAsync() atau IncrementAsync() .

Lihat Toko Data untuk panduan umum tentang menggunakan toko data terurut.

Contoh Kode

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

Rangkuman

Metode

Metode diwarisi dari GlobalDataStore

Properti

Metode

GetSortedAsync

Hasil

Kembalikan objek DataStorePages .Urutan sortir ditentukan oleh naik , panjang setiap halaman oleh ukuran halaman , dan minValue / maxValue adalah parameter opsional yang menyaring hasil.

Lihat Toko Data untuk batas permintaan dan deskripsi kode kesalahan.

Parameter

ascending: boolean

Boolean yang menunjukkan apakah halaman data yang dikembalikan berada dalam urutan menaik.

Nilai Default: ""
pagesize: number

Panjang setiap halaman. Nilai maksimum yang diizinkan adalah 50. Nilai maksimum yang diizinkan adalah 100.

Nilai Default: ""
minValue: Variant

Parameter opsional. Jika diatur, halaman data dengan nilai kurang dari minValue akan dikecualikan.

Nilai Default: ""
maxValue: Variant

Parameter opsional. Jika diatur, halaman data dengan nilai lebih besar dari maxValue akan dikecualikan.

Nilai Default: ""

Memberikan nilai

Sebuah objek terurut DataStorePages berdasarkan argumen yang disediakan.

Acara