OrderedDataStore
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
Bir SıralanmışVeriDeposu temelde depolanan değerlerin pozitif sayılar olması koşuluyla olumlu sayılar dır.Sıralanmış sırayla girişlerin incelenmesine izin veren bir yöntemi GetSortedAsync() ortaya çıkarır, bir DataStorePages nesnesi kullanarak.
Sıralanmış veri depoları sürümleme ve metadatayı desteklemiyor, bu nedenle daima bir için anahtarlar için geçerlidir.Versiyonlama ve metadat desteğine ihtiyacınız varsa, bir DataStore kullanın.
Sıralanmış veri depoları, SetAsync() veya IncrementAsync() için seçilen userIds parametresini desteklemez.
Sıralı veri depolarının kullanımına genel bakış için Veri Depolarına bakın.
Kod Örnekleri
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()
Özet
Özellikler
Yöntemler
- GetSortedAsync(ascending : boolean,pagesize : number,minValue : Variant,maxValue : Variant):DataStorePages
Bir DataStorePages nesnesi döndürür.
Yöntemler
Belirtilen veri depolamasındaki bir anahtarın değerini ve bir DataStoreKeyInfo durumdöndürür.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Verilen miktar ile bir anahtarın değerini artırır (her ikisi de tamsayı olmalıdır).
Belirtilen anahtarı kaldırırken erişilebilir bir sürüm de korur.
Verilen anahtar için veri depolama değerini ayarlar.
Bir anahtarın değerini belirtilen geri çağrı işlevinden yeni bir değerle günceller.