OrderedDataStore
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
Một OrderedDataStore là thực tế là một GlobalDataStore với ngoại lệ rằng giá trị lưu trữ phải là số nguyên tích dương . Nó hiển thị một phương thức 1> Class.OrderedDataStore:GetSortedAsync()|
Các cửa hàng dữ liệu đã được lưu không hỗ trợ phiên bản và metadữ, vì vậy DataStoreKeyInfo luôn luôn là nil cho các khóa trong một OrderedDataStore . Nếu bạn cần hỗ trợ phiên bản và metadữ, hãy sử dụ
Các cửa hàng dữ liệu đã đặt hàng không hỗ trợ tham số bắt buộc userIds đối với SetAsync() hoặc IncrementAsync() .
Xem Data Stores cho một tổng quát về cách sử dụng các cửa hàng dữ liệu đã đặt.
Mẫu mã
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()
Tóm Tắt
Phương Pháp
Trả lại một đối tượng DataStorePages .
Trả lại giá trị của một chìa khóa trong một lưu trữ dữ liệu được xác định và một DataStoreKeyInfo ví dụ / trường hợp.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Tăng giá trị của một chìa khóa bằng số lượng cung cấp (cả hai phải là số lượng).
Loại bỏ chìa khóa được chỉ định trong khi giữ một phiên bản truy cập được.
Điều chỉnh giá trị của cửa hàng dữ liệu cho giá trị đã được cung chìa khóa.
Cập nhật giá trị của một chìa khóa bằng một giá trị mới từ hàm chuỗi đã định.
Thuộc Tính
Phương Pháp
GetSortedAsync
Trả lại một DataStorePages đối tượng. Thứ tự sắp xếp được xác định bằng tăng dần , chiều dài của mỗi trang bởi pageSize và 1> minValue1> / 4> maxValue4> là các biến độ 7> lọc7> kết quả.
Xem Data Stores cho giới hạn yêu cầu và mô tả của các mã lỗi.
Tham Số
Một biểu tượngBoolean cho biết có phải trang dữ liệu đã trả lại được sắp xếp theo một trình tăng dần không.
Độ dài của mỗi trang. Mặc định là 50. Giá trị tối đa được cho phép là 100.
Tham số tùy chọn. Nếu được cài đặt, các trang dữ liệu với giá trị nhỏ hơn minValue sẽ bị loại trừ.
Đối số này tùy chọn. Nếu được cài đặt, các trang dữ liệu với giá trị lớn hơn maxValue sẽ bị loại trừ.
Lợi Nhuận
Một đối tượng DataStorePages sắp xếp dựa trên các đại diện cung cấp.