OrderedDataStore

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

만들 수 없음

복제되지 않음

OrderedDataStore는 일반적으로 GlobalDataStore 와 같지만, 저장된 값이 음수 정수 여야 합니다. 이는 1> Class.OrderedDataStore:GetSortedAsync()|GetSortedAsync()1> 메서드를 사용하여 정렬된 항목을 검사하는

주문된 데이터 저장소는 버전 관리 및 메타데이터를 지원하지 않으므로 DataStoreKeyInfo 는 항상 nil 이 키에 대해 OrderedDataStore 입니다. 버전 관리 및 메타데이터 지원이 필요한 경우 1> Class.DataStore1> 를 사용하십시오.

주문된 데이터 저장소는 userIds 또는 SetAsync() 에 대한 옵션적인 IncrementAsync() 매개 변수를 지원하지 않습니다.

정렬된 데이터 저장소의 사용에 대한 개요는 데이터 저장소를 참조하십시오.

코드 샘플

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

요약

속성

Instance에서 상속된 모든 항목 보기

Object에서 상속된 모든 항목 보기

메서드

GetSortedAsync(ascending : bool,pagesize : number,minValue : Variant,maxValue : Variant):Instance
생성
Class.DataStorePages 개체를 반환합니다.

메서드가 GlobalDataStore에서 상속되었습니다

GetAsync(key : string,options : DataStoreGetOptions):Tuple
생성
지정된 데이터 저장소의 키 값과 DataStoreKeyInfo 인스턴스를 반환합니다.
IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
생성
지정된 값으로 키의 값을 증가시킵니다(둘 다 정수여야 함).
RemoveAsync(key : string):Tuple
생성
액세스 가능한 버전을 유지하면서 지정된 키를 제거합니다.
SetAsync(key : string,value : Variant,userIds : Array,options : DataStoreSetOptions):Variant
생성
지정된 키에 대한 데이터 저장소의 값을 설정합니다.
UpdateAsync(key : string,transformFunction : function):Tuple
생성
지정된 콜백 함수에서 새로운 값을 사용하여 키의 값을 업데이트합니다.