Mẫu này bao gồm một hàm đơn giản để thay đổi kết cấu của `Shirt`
và `Pants` mà nhân vật của người chơi đang mặc. Nếu áo và quần không tồn tại thì
chúng sẽ được tạo ra. Lưu ý, điều này nên được chạy mỗi khi nhân vật xuất hiện. Nếu
một nhà phát triển muốn thay đổi vĩnh viễn diện mạo của nhân vật thành một
cấu hình trước, họ nên sử dụng `Class.Player.CharacterAppearance`.

Đối tượng `Pants` hiển thị một kết cấu quần từ Roblox trên một `Class.Humanoid`
rig. Quần che cơ thể và chân, và sẽ được che bởi một `Class.Shirt` trên
cơ thể. Để có thể nhìn thấy, một `Pants` phải là anh chị em của một `Class.Humanoid`
và có thuộc tính `Class.Pants.PantsTemplate|PantsTemplate` được thiết lập thành một
kết cấu phù hợp như `rbxassetid://86896501`. Kết cấu quần có thể được
màu hóa bằng cách sử dụng thuộc tính `Class.Clothing.Color3`.

Quần tự động được tải trên nhân vật `Class.Player` nếu avatar của họ
đang mặc một.


Pants

Liên kết ID nội dung chỉ đến mẫu quần được lưu trữ trên Roblox.

ID nội dung này khác với URL trang web của quần. Nó có thể được
tìm thấy bằng cách dán URL trang web của quần vào thuộc tính **PantsTemplate**
trong Studio. Ngoài ra, `Class.InsertService:LoadAsset()` có thể
được sử dụng để chèn quần vào workspace, ví dụ:

```
local InsertService = game:GetService("InsertService")
local Workspace = game:GetService("Workspace")

local webURL = "https://www.roblox.com/catalog/1804739/Jeans"
local assetId = tonumber(string.match(webURL, "%d+") or 0)  -- Trích xuất số
local success, model = pcall(function()
	return InsertService:LoadAsset(assetId)
end)
if success then
	model.Parent = Workspace
end
```
Đối với mẫu của đối tượng `Class.Shirt`, xem `Class.Shirt.ShirtTemplate`.


Pants.PantsTemplate

Xác định kết cấu của `Class.Pants`.


Hiển thị một kết cấu Quần từ trang web Roblox để hiển thị trên một
`Class.Humanoid` rig.


Lớp cơ sở cho các đối tượng quần áo.


Clothing

Thuộc tính này xác định màu sắc sẽ được áp dụng cho kết cấu
`Class.Clothing`. Giá trị màu sắc mặc định là
`Datatype.Color3|Color3.new(1, 1, 1)` (màu trắng), khi đó không có màu sắc nào được áp dụng.

Thuộc tính này hữu ích cho việc tạo ra các bộ trang phục có nhiều
biến thể màu khác nhau nhưng có ngoại hình cơ bản giống nhau, có thể dành cho
một ứng dụng tạo nhân vật trong trò chơi nhập vai hoặc tạo ra nhiều
NPC khác nhau.

Xem thêm `Class.ShirtGraphic.Color3`, xác định màu sắc sẽ được
áp dụng cho kết cấu `Class.ShirtGraphic`.


Clothing.Color3

Xác định màu sắc sẽ được áp dụng cho kết cấu `Class.Clothing`.


Quần áo là lớp cơ sở cho các đối tượng quần áo `Class.Shirt` và `Class.Pants`.


Lớp cơ sở cho các đối tượng thay đổi ngoại hình của một nhân vật.


CharacterAppearance

Lớp cơ sở cho các đối tượng thay đổi ngoại hình của nhân vật, chẳng hạn như các đối tượng
`Class.BodyColors`, `Class.CharacterMesh`, `Class.ShirtGraphic`, `Class.Pants`
và `Class.Shirt`.


`Instance` là lớp cơ sở cho tất cả các lớp trong hệ thống lớp của Roblox
có thể là một phần của cây `Class.DataModel`.

Không thể tạo các đối tượng `Instance` gốc trực tiếp, nhưng hàm khởi tạo đặc biệt
`Datatype.Instance.new()` tạo ra các đối tượng thông qua mã, lấy tên của lớp làm tham số
và trả về đối tượng đã tạo.

Minh họa việc phát hiện sự thay đổi trong tổ tiên của một instance bằng cách kết nối với sự kiện `Class.Instance.AncestryChanged`.

Parent của ChangingPart được đặt thành các giá trị khác nhau theo thời gian. Parent của part là tổ tiên của part, vì vậy sự kiện `Class.Instance.AncestryChanged` sẽ được kích hoạt bất cứ khi nào nó thay đổi.

Kích hoạt khi thuộc tính `Class.Instance.Parent` của đối tượng hoặc một
trong những tổ tiên của nó bị thay đổi.

Sự kiện này bao gồm hai tham số: `child` đại diện cho `Class.Instance`
đã thực sự bị thay đổi thuộc tính `Class.Instance.Parent`, trong khi `parent` đại diện
cho `Class.Instance.Parent` mới của phiên bản này.

Bạn có thể sử dụng sự kiện này để theo dõi sự xóa của một phiên bản trong Studio,
như việc xóa thủ công trong Explorer hoặc thông qua một plugin. Nếu bạn cần
phát hiện khi một phiên bản bị hủy bằng `Class.Instance:Destroy()`, hãy sử dụng
event `Class.Instance.Destroying` thay thế.

Instance.AncestryChanged

child

`Class.Instance` có thuộc tính `Class.Instance.Parent` đã bị thay đổi.

parent

Giá trị `Class.Instance.Parent` mới của `Class.Instance` mà
`Class.Instance.Parent` đã bị thay đổi.

Kích hoạt khi thuộc tính `Class.Instance.Parent` của đối tượng hoặc một
trong những tổ tiên của nó bị thay đổi.

Sự kiện này kích hoạt bất cứ khi nào bất kỳ thuộc tính nào bị thay đổi trên phiên bản,
bao gồm khi một thuộc tính được đặt thành `nil`. Tên của thuộc tính đã thay đổi
được chuyển đến hàm kết nối.

Ví dụ, đoạn mã sau đây kết nối hàm `attributeChanged()` để kích hoạt bất cứ khi nào một
trong các thuộc tính của phần thay đổi:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "đã thay đổi")
end

part.AttributeChanged:Connect(attributeChanged)
```
Tham khảo thêm `Class.Instance:GetAttributeChangedSignal()` mà trả về sự kiện kích hoạt
khi một thuộc tính cụ thể được thay đổi.

Instance.AttributeChanged

attribute

Tên của thuộc tính đã bị thay đổi.

Kích hoạt bất cứ khi nào một thuộc tính bị thay đổi trên `Class.Instance`.

Đoạn mã này in ra tên của các đối tượng khi chúng được thêm vào Workspace:

Kích hoạt sau khi một đối tượng được làm cha của `Class.Instance` này.

Lưu ý, khi sử dụng phương thức này trên client để phát hiện các đối tượng được tạo bởi máy chủ,
cần thiết phải sử dụng `Class.Instance:WaitForChild()` khi
lập chỉ mục các tổ tiên của những đối tượng này. Điều này là do đối tượng và các tổ tiên của nó
không được đảm bảo nhân bản từ máy chủ đến client
đồng thời. Ví dụ:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- Sử dụng WaitForChild() vì các tổ tiên có thể chưa nhân bản
	local head = child:WaitForChild("Head")
end)
```
Lưu ý, sự kiện này chỉ hoạt động cho các đối tượng con ngay lập tức của
`Class.Instance`. Đối với một sự kiện thu thập tất cả các tổ tiên, hãy sử dụng
`Class.Instance.DescendantAdded`.

Xem thêm `Class.Instance.ChildRemoved`.

Instance.ChildAdded

`Class.Instance` đã được thêm vào.

Kích hoạt sau khi một đối tượng được nuôi nấng vào `Class.Instance` này.

Đoạn mã này in ra tên của các đối tượng khi chúng bị xóa khỏi
Workspace:

Kích hoạt sau khi một đối tượng con bị loại bỏ khỏi `Class.Instance` này.

Bị loại bỏ đề cập đến khi cha của một đối tượng được thay đổi từ `Class.Instance`
sang một cái gì đó khác ngoài `Class.Instance`. Lưu ý, sự kiện này
cũng sẽ được kích hoạt khi một đối tượng con bị xóa (sử dụng
`Class.Instance:Destroy()`) vì hàm xóa đặt cha của một đối tượng thành `nil`.

Sự kiện này chỉ hoạt động cho các đối tượng con ngay lập tức của
`Class.Instance`. Đối với một sự kiện thu thập tất cả các tổ tiên, hãy sử dụng
`Class.Instance.DescendantRemoving`.

Xem thêm `Class.Instance.ChildAdded`.

Instance.ChildRemoved

Kích hoạt sau khi một đứa trẻ bị xóa khỏi `Class.Instance` này.

Ví dụ dưới đây sẽ in ra tên của bất kỳ đối tượng nào được thêm vào
Workspace:

Sự kiện này kích hoạt sau khi một đời con được thêm vào `Class.Instance`.

Do nó kích hoạt cho mọi đời con, việc nuôi nấng một đối tượng vào `Class.Instance` sẽ
kích hoạt sự kiện cho đối tượng này và tất cả các đời con của nó một cách riêng biệt.

Nếu bạn chỉ quan tâm đến **các trẻ trực tiếp** của `Class.Instance`, hãy sử dụng
`Class.Instance.ChildAdded` thay thế.

Tham khảo thêm `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Kích hoạt sau khi một đời con được thêm vào `Class.Instance`.

Ví dụ sau in tên của bất kỳ đối tượng con nào khi nó đang được gỡ ra
khỏi Workspace:

Sự kiện này kích hoạt **ngay trước** khi cha `Class.Instance`
thay đổi đến mức một phiên bản **đời con** sẽ không còn là một đời con nữa.
`Class.Instance:Destroy()|Destroy()` thay đổi `Class.Instance.Parent|Parent` của một
phiên bản thành `nil`, vì vậy việc gọi phương thức đó trên một đời con của
cha sẽ khiến sự kiện này được kích hoạt.

Vì sự kiện này kích hoạt **trước** khi đứa con bị xóa, cha của đứa con sẽ
không bị thay đổi vào thời điểm xảy ra sự kiện này. Nếu đứa con cũng là một **trẻ trực tiếp**
của cha, sự kiện này sẽ được kích hoạt trước `Class.Instance.ChildRemoved`.

Nếu một đứa con có trẻ con, sự kiện này sẽ kích hoạt với đứa con trước,
được theo sau bởi các đời con của nó.

##### Cảnh báo

Sự kiện này sẽ kích hoạt với đối tượng đời con đang bị xóa.
Cố gắng đặt `Class.Instance.Parent|Parent` của đứa con thành
một cái gì đó khác sẽ thất bại. Dưới đây là một ví dụ chứng minh điều này:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Không thao tác với cha của đời con trong hàm này!
	-- Sự kiện này kích hoạt BỞI vì cha đã bị thao tác, và sự thay đổi vẫn chưa xảy ra
	-- Do đó, thật vô lý khi thay đổi cha như thế này:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Tham khảo thêm `Class.Instance.DescendantAdded|DescendantAdded`.

Instance.DescendantRemoving

Kích hoạt ngay trước khi một đời con của `Class.Instance` bị xóa.

Mẫu này minh họa cách mà, khi sử dụng hành vi tín hiệu ngay lập tức, một Instance bị phá hủy sẽ giữ nguyên vị trí cho đến khi chức năng kết nối dừng lại.

Ví dụ này thể hiện cách mà, khi sử dụng hành vi tín hiệu hoãn,
   một Instance sẽ bị hủy trước khi tín hiệu được phát.

Đối tượng `Class.Instance` sẽ không bao giờ bị xóa khỏi bộ nhớ trong khi một hàm
kết nối vẫn đang sử dụng nó. Tuy nhiên, nếu hàm đó tạm dừng bất cứ lúc nào,
đối tượng `Class.Instance` và các đời con của nó sẽ được đặt thành `nil`.

Nếu thuộc tính `Class.Workspace.SignalBehavior` được đặt thành
`Enum.SignalBehavior.Immediate`, sự kiện này sẽ kích hoạt ngay trước khi
`Class.Instance` hoặc một trong những tổ tiên của nó bị hủy bằng
`Class.Instance:Destroy()`.

Nếu thuộc tính `Class.Workspace.SignalBehavior` được đặt thành
`Enum.SignalBehavior.Deferred`, sự kiện này sẽ kích hoạt tại điểm khôi phục tiếp theo,
điều này sẽ xảy ra sau khi `Class.Instance` hoặc một trong những tổ tiên của nó bị
hủy bằng `Class.Instance:Destroy()`.

Với hành vi `Enum.SignalBehavior.Deferred|Deferred`, việc kết nối một kịch bản
với sự kiện `Class.Instance.Destroying` của chính nó là gặp vấn đề, vì kịch bản đó
sẽ bị hủy trước khi hàm callback có thể được gọi (nghĩa là nó sẽ không thực thi).

Khi xóa một `Class.Instance` trong Studio, chẳng hạn như xóa thủ công
thông qua [Explorer](/studio/explorer) hoặc thông qua một plugin,
`Class.Instance` không bị hủy. Thay vào đó, cha của nó được đặt thành `nil`
điều này bạn có thể theo dõi bằng `Class.Instance.AncestryChanged`.

Instance.Destroying

Kích hoạt ngay trước (hoặc bị hoãn cho đến sau) khi phiên bản bị
hủy thông qua `Class.Instance:Destroy()`.

Sự kiện này kích hoạt bất cứ khi nào bất kỳ thuộc tính kiểu dáng nào bị thay đổi trên phiên bản,
bao gồm khi một thuộc tính được đặt thành `nil`.

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("Các thuộc tính kiểu dáng đã thay đổi")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```

Instance.StyledPropertiesChanged

Kích hoạt bất cứ khi nào bất kỳ thuộc tính kiểu dáng nào bị thay đổi trên phiên bản,
bao gồm khi một thuộc tính được đặt thành `nil`.

Instance.childAdded

Phương thức này áp dụng một thẻ cho instance, không có tác động nếu thẻ đã
được áp dụng. Việc thêm thẻ thành công sẽ kích hoạt một tín hiệu được tạo bởi
`Class.CollectionService:GetInstanceAddedSignal()` với thẻ đã cho.

##### Cảnh báo

- Các thẻ của một instance được thêm từ phía khách sẽ bị xóa nếu máy chủ
  sau đó thêm hoặc loại bỏ một thẻ trên instance đó bởi vì máy chủ
  nhân bản tất cả các thẻ cùng nhau và ghi đè các thẻ trước đó.

- Khi gán thẻ cho một instance, thường có một số tài nguyên được sử dụng để
  cung cấp chức năng cho thẻ, chẳng hạn như kết nối sự kiện hoặc bảng.
  Để ngăn ngừa rò rỉ bộ nhớ, sẽ là một ý tưởng hay để làm sạch những tài nguyên này
  (ngắt kết nối, đặt về `nil`, v.v.) khi không còn cần thiết cho một thẻ. Thực hiện điều này khi
  gọi `Class.Instance:RemoveTag()`, gọi
  `Class.Instance:Destroy()`, hoặc trong một hàm được kết nối với một tín hiệu
  được trả về bởi `Class.CollectionService:GetInstanceRemovedSignal()`.

Instance:AddTag

Phương thức này xóa tất cả các đối tượng con và tổ tiên của một thể hiện.

```
local part = Instance.new("Part")

-- Thêm một số ánh sáng lấp lánh
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
Nếu bạn không muốn xóa **tất cả** các đối tượng con và tổ tiên, hãy sử dụng `Class.Instance:GetChildren()` hoặc `Class.Instance:GetDescendants()` để lặp qua các đối tượng con/tổ tiên đó và chọn những gì cần xóa. Ví dụ, đoạn mã sau sẽ xóa tất cả `Class.BasePart|BaseParts` từ một `Class.Model`:

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```

Instance:ClearAllChildren

Phương thức này xóa tất cả các đối tượng con của một thể hiện.

Chứng minh việc nhân bản một mô hình bằng cách sử dụng `Class.Instance:Clone()`.

`Clone()` tạo một bản sao của một đối tượng và tất cả các con của nó,
đồng thời bỏ qua tất cả các đối tượng không phải là
`Class.Instance.Archivable|Archivable`. Bản sao của đối tượng gốc được
trả về bởi phương thức này và `Class.Instance.Parent|Parent` của nó được
thiết lập thành `nil`. Lưu ý rằng nếu đối tượng đó có
`Class.Instance.Archivable|Archivable` được thiết lập thành `false`, phương thức này sẽ
trả về `nil`.

Nếu một thuộc tính tham chiếu như `Class.ObjectValue.Value` được thiết lập trong một
đối tượng đã sao chép, giá trị của thuộc tính trong bản sao phụ thuộc vào
giá trị của đối tượng gốc:

- Nếu một thuộc tính tham chiếu tham chiếu tới một đối tượng cũng được **sao chép**,
  bản sao sẽ tham chiếu tới bản sao.
- Nếu một thuộc tính tham chiếu tham chiếu tới một đối tượng không **được** sao chép,
  cùng một giá trị được duy trì trong bản sao.


Instance:Clone

Tạo một bản sao của một instance và tất cả các phần tử con của nó, bỏ qua các instancet
không phải là `Class.Instance.Archivable|Archivable`.

Minh họa việc phá hủy một Phần sử dụng hàm `Class.Instance:Destroy()`.

Hàm này là cách chính xác để giải phóng các đối tượng không còn cần thiết.

Đặt thuộc tính `Class.Instance.Parent` thành `nil`, khóa thuộc tính `Class.Instance.Parent`, ngắt tất cả các kết nối và gọi `Destroy()` trên tất cả các đối tượng con. Phương thức này là cách đúng để xử lý các đối tượng không còn cần thiết.

Việc xử lý các đối tượng không cần thiết là quan trọng, vì các đối tượng và kết nối không cần thiết trong một nơi sử dụng bộ nhớ có thể dẫn đến các vấn đề hiệu suất nghiêm trọng theo thời gian.

Là một thực tiễn tốt nhất sau khi gọi `Destroy()` trên một đối tượng, hãy đặt bất kỳ biến nào tham chiếu đến đối tượng (hoặc tổ tiên của nó) thành `nil`. Điều này ngăn chặn mã của bạn truy cập vào bất kỳ điều gì liên quan đến đối tượng.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Đừng làm điều này:
print(part.Name)  --> "Hello, world"
-- Làm điều này để ngăn dòng trên hoạt động:
part = nil
```
Một khi một `Class.Instance` đã được xóa bởi phương thức này, nó không thể được tái sử dụng vì thuộc tính `Class.Instance.Parent` đã bị khóa. Để **tạm thời** gỡ bỏ một đối tượng thay vì xóa nó, hãy đặt `Class.Instance.Parent|Parent` thành `nil`. Ví dụ:

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Để xóa một đối tượng sau một khoảng thời gian nhất định, hãy sử dụng `Class.Debris:AddItem()`.

Instance:Destroy

Đặt thuộc tính `Class.Instance.Parent` thành `nil`, khóa thuộc tính
`Class.Instance.Parent`, ngắt kết nối tất cả các kết nối, và gọi
`Destroy()` trên tất cả các trẻ em.

Trả về tổ tiên đầu tiên của `Class.Instance` mà có
`Class.Instance.Name` bằng với tên đã cho.

Phương thức này làm việc theo chiều lên, có nghĩa là nó bắt đầu từ `Class.Instance.Parent` ngay lập tức và làm việc lên tới `Class.DataModel`. Nếu không tìm thấy tổ tiên phù hợp, nó trả về `nil`.

Đoạn mã sau sẽ tìm tổ tiên đầu tiên của đối tượng có tên `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Đối với các biến thể của phương thức này tìm tổ tiên của một lớp cụ thể, vui lòng xem `Class.Instance:FindFirstAncestorOfClass()` và `Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

Đối tượng `Class.Instance` được tìm thấy.

Trả về tổ tiên đầu tiên của `Class.Instance` mà
`Class.Instance.Name` bằng với tên đã cho.

Trả về tổ tiên đầu tiên của `Class.Instance` mà có
`Class.Object.ClassName` bằng với `className` đã cho.

Phương thức này làm việc theo chiều lên, có nghĩa là nó bắt đầu từ `Class.Instance.Parent` ngay lập tức và làm việc lên tới `Class.DataModel`. Nếu không tìm thấy tổ tiên phù hợp, nó trả về `nil`.

Một cách sử dụng phổ biến của phương thức này là tìm `Class.Model` mà một `Class.BasePart` thuộc về. Ví dụ:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Phương thức này là một biến thể của `Class.Instance:FindFirstAncestor()` kiểm tra thuộc tính `Class.Object.ClassName` thay vì `Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` cũng
có, sử dụng phương thức `Class.Object:IsA()` thay thế để tôn trọng kế thừa lớp.

Instance:FindFirstAncestorOfClass

className

Tên `Class.Object.ClassName` cần tìm.

Trả về tổ tiên đầu tiên của `Class.Instance` mà
`Class.Object.ClassName` bằng với className đã cho.

Trả về tổ tiên đầu tiên của `Class.Instance` mà cho
`Class.Object:IsA()` trả về đúng cho `className` đã cho.

Phương thức này làm việc theo chiều lên, có nghĩa là nó bắt đầu từ `Class.Instance.Parent` ngay lập tức và làm việc lên tới `Class.DataModel`. Nếu không tìm thấy tổ tiên phù hợp, nó trả về `nil`.

Khác với `Class.Instance:FindFirstAncestorOfClass()`, phương thức này sử dụng
`Class.Object:IsA()` tôn trọng kế thừa lớp. Ví dụ:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Do đó, đoạn mã sau sẽ trả về tổ tiên đầu tiên là `Class.BasePart`, bất kể nó có phải là `Class.WedgePart`, `Class.MeshPart` hay `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Xem thêm `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Trả về tổ tiên đầu tiên của `Class.Instance` mà
`Class.Object:IsA()` trả về đúng cho className đã cho.

Phía dưới sẽ tìm kiếm trong Workspace cho một đối tượng có tên là "Brick". Nếu tìm thấy, nó
sẽ thay đổi tên của đối tượng thành "Foo".

Trả về đối tượng con đầu tiên của `Class.Instance` với tên đã cho, hoặc
`nil` nếu không tồn tại đối tượng con nào như vậy. Nếu tham số tùy chọn `recursive` là
`true`, phương thức này tìm kiếm tất cả các tổ tiên thay vì chỉ các đối tượng con ngay lập tức của `Class.Instance`.

##### Kiểm tra Sự tồn tại của một Đối tượng

`FindFirstChild()` là cần thiết nếu bạn cần xác minh một đối tượng tồn tại
trước khi tiếp tục. Cố gắng lập chỉ mục một đối tượng con theo tên bằng toán tử chấm sẽ gây ra lỗi nếu đối tượng con không tồn tại.

```lua
local Workspace = game:GetService("Workspace")

-- Dòng sau đây sẽ lỗi nếu phần không tồn tại trong không gian làm việc
Workspace.Part.Transparency = 0.5
```
Cách tiếp cận tốt hơn là sử dụng `FindFirstChild()` để kiểm tra `Part`,
rồi sau đó sử dụng câu lệnh `if` để chạy mã cần nó.

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

##### Tìm một Đối tượng con có Tên phù hợp với một Thuộc tính

Đôi khi tên `Class.Instance.Name|Name` của một đối tượng là giống với
thuộc tính của `Class.Instance.Parent|Parent`. Khi sử dụng toán tử chấm, các thuộc tính ưu tiên hơn các đối tượng con nếu chúng có cùng tên.

Trong ví dụ sau, một `Class.Folder` có tên `Color` được thêm vào một
`Class.Part`, cũng có thuộc tính `Class.Part.Color`. Lưu ý rằng
`part.Color` tham chiếu đến giá trị thuộc tính `Datatype.Color3`, không phải thể hiện `Class.Folder` con. Một lợi ích khi sử dụng
`Class.Instance:FindFirstChild()|FindFirstChild()` là sự xuất hiện của các thuộc tính mới không gây ra rủi ro cho mã của bạn.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- Thuộc tính
local c2 = part:FindFirstChild("Color")  -- Thư mục con
```

##### Ghi chú về Hiệu suất

`Class.Instance:FindFirstChild()|FindFirstChild()` mất khoảng 20% thời gian hơn so với việc sử dụng toán tử chấm và gần 8 lần lâu hơn so với việc chỉ đơn giản lưu trữ
một tham chiếu đến một đối tượng. Do đó, bạn nên tránh gọi nó trong
mã phụ thuộc vào hiệu suất như trong các vòng lặp chặt chẽ hoặc các hàm được kết nối với
`Class.RunService.Heartbeat` và `Class.RunService.PreRender`. Thay vào đó,
hãy lưu kết quả trong một biến hoặc xem xét sử dụng
`Class.Instance.ChildAdded|ChildAdded` hoặc
`Class.Instance:WaitForChild()|WaitForChild()` để phát hiện khi một đối tượng con có tên nhất định trở nên khả dụng.

Instance:FindFirstChild

recursive

Liệu tìm kiếm có nên được thực hiện đệ quy hay không.

Trả về đứa trẻ đầu tiên của `Class.Instance` được tìm thấy với tên đã cho.

Trả về đối tượng con đầu tiên của `Class.Instance` mà có
`Class.Object.ClassName|ClassName` bằng với `className` đã cho.
Khác với `Class.Instance:FindFirstChildWhichIsA()`, phương thức này chỉ trả về
các đối tượng mà lớp của nó phù hợp với `className`, bỏ qua việc kế thừa lớp. Nếu không tìm thấy con phù hợp, phương thức này trả về `nil`.

Instance:FindFirstChildOfClass

Trả về đứa trẻ đầu tiên của `Class.Instance` mà
`Class.Object.ClassName|ClassName` bằng với tên lớp đã cho.

Trả về đối tượng con đầu tiên của `Class.Instance` mà cho
`Class.Object:IsA()` trả về đúng cho `className` đã cho.

Nếu không tìm thấy con phù hợp, phương thức này trả về `nil`. Nếu tham số
tùy chọn `recursive` là true, phương thức này sẽ tìm kiếm tất cả các tổ tiên thay vì chỉ các đối tượng con ngay lập tức của `Class.Instance`.

Khác với `Class.Instance:FindFirstChildOfClass()`, phương thức này sử dụng
`Class.Object:IsA()` tôn trọng kế thừa lớp. Ví dụ:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Do đó, đoạn mã sau sẽ trả về đối tượng con đầu tiên là `Class.BasePart`, bất kể nó có phải là `Class.WedgePart`,
`Class.MeshPart` hay `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Các nhà phát triển tìm kiếm một đối tượng con theo tên nên sử dụng
`Class.Instance:FindFirstChild()` thay vào đó.

Instance:FindFirstChildWhichIsA

Trả về đứa trẻ đầu tiên của `Class.Instance` mà
`Class.Object:IsA()` trả về đúng cho className đã cho.

Trả về phần tử con đầu tiên được tìm thấy với `Class.Instance.Name` đã cho.

Phương thức này bị vô hiệu hóa và không thể sử dụng. Để tìm phần tử con đầu tiên
của một instance, hãy xem xét việc sử dụng tham số `recursive` trên
`Class.Instance:FindFirstChild()` thay vào đó.

Instance:FindFirstDescendant

Trả về phần tử con đầu tiên được tìm thấy với `Class.Instance.Name` đã cho.

Nếu `Class.Instance` là một `Class.Actor`, thì `Class.Actor` bản thân nó được
trả về. Nếu không, tổ tiên gần nhất của nó là `Class.Actor` được trả về. Nếu không có
tổ tiên nào là `Class.Actor`, kết quả là `nil`.

Instance:GetActor

Đối tượng `Class.Actor` được tìm thấy.

Trả về `Class.Actor` liên kết với Instance, nếu có.

Phương thức này trả về giá trị đã được gán cho tên thuộc tính đã cho. Nếu không có thuộc tính nào đã được gán, `nil` được trả về.

Ví dụ, đoạn mã sau đây đặt và sau đó lấy giá trị của thuộc tính `InitialPosition`
của instance:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

##### Xem Thêm

- `Class.Instance:SetAttribute()` mà đặt thuộc tính với tên đã cho thành giá trị đã cho.
- `Class.Instance:GetAttributes()` mà trả về một từ điển các cặp khóa-giá trị cho mỗi thuộc tính của instance.

Instance:GetAttribute

Tên của thuộc tính đang được lấy.

Giá trị đã được gán cho tên thuộc tính đã cho. Nếu không có thuộc tính nào đã được gán, `nil` được trả về.

Trả về giá trị đã được gán cho tên thuộc tính đã cho.

Phương thức này trả về một sự kiện hoạt động chính xác như
sự kiện `Class.Object.Changed|Changed`, ngoại trừ việc nó chỉ kích hoạt khi thuộc tính cho trước thay đổi; hiệu quả giống như
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` nhưng cho các thuộc tính.

Thường là một ý tưởng tốt để sử dụng phương thức này thay vì một kết nối đến
`Class.Object.Changed|Changed` với một hàm kiểm tra tên thuộc tính. Các cuộc gọi sau đó đến phương thức này trên cùng một đối tượng với cùng một
tên thuộc tính sẽ trả về cùng một sự kiện.

Ví dụ mã sau trả về một tín hiệu sẽ kích hoạt hàm
`attributeChanged()` khi thuộc tính `InitialPosition` của phần thay đổi:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("Thuộc tính đã thay đổi")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Xem thêm `Class.Instance.AttributeChanged` kích hoạt bất cứ khi nào bất kỳ thuộc tính nào được thay đổi trên thể hiện.

Instance:GetAttributeChangedSignal

Tên thuộc tính đã chỉ định mà tín hiệu thay đổi đang được trả về.

Một sự kiện xảy ra khi thuộc tính đã cho thay đổi.

Trả về một sự kiện mà xảy ra khi thuộc tính đã cho thay đổi.

Phương thức này trả về một từ điển chứa các cặp khóa-giá trị cho mỗi thuộc tính
nơi khóa là tên thuộc tính và giá trị là giá trị không phải là `nil`.

Ví dụ, đoạn mã sau đây xuất ra các thuộc tính và giá trị của một instance:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
Xem thêm `Class.Instance:GetAttribute()` mà trả về giá trị đã được gán cho tên thuộc tính đã cho.

Instance:GetAttributes

Một từ điển của các cặp chuỗi → biến cho mỗi thuộc tính mà
chuỗi là tên của thuộc tính và biến là một giá trị không phải `nil`.

Trả về một từ điển chứa các thuộc tính của instance.

Dưới đây sẽ in tên của tất cả các đối tượng hiện tại trong Workspace khi chạy.

Trả về một mảng (một bảng chỉ số số) chứa tất cả các
đối tượng con trực tiếp của thể hiện, hoặc mọi `Class.Instance` mà
`Class.Instance.Parent|Parent` bằng với đối tượng. Mảng có thể được
lặp qua bằng cách sử dụng vòng lặp số hoặc vòng lặp tổng quát:

```lua
local Workspace = game:GetService("Workspace")

-- Ví dụ vòng lặp số
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " là đối tượng con số " .. i)
end
```

```lua
local Workspace = game:GetService("Workspace")

-- Ví dụ vòng lặp tổng quát
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " là đối tượng con số " .. i)
end
```
Lưu ý rằng mảng **không** được sắp xếp theo bất kỳ thứ tự nào, vì vậy việc sắp xếp thủ công (ví dụ sử dụng `Library.table.sort()`) là được khuyến khích để sắp xếp
các đối tượng con mà phương thức này trả về.

Xem thêm phương thức `Class.Instance:GetDescendants()|GetDescendants()`.

Instance:GetChildren

Một mảng chứa các con của instance.

Trả về một mảng chứa tất cả các con của instance.

Trả về một chuỗi mã hóa của ID gỡ lỗi được sử dụng nội bộ bởi Roblox. Lưu ý rằng:

- Mục này đã được bảo vệ. Cố gắng sử dụng nó trong `Class.Script` hoặc
  `Class.LocalScript` sẽ gây ra lỗi.
- ID gỡ lỗi là ID được sử dụng trong quy trình gỡ lỗi. Nó cho phép một trình gỡ lỗi đọc từng lệnh trước khi một ứng dụng thực hiện nó. Tất cả các đối tượng trong
  Roblox hoạt động giống như các quy trình và mỗi lệnh (hoặc 'mã') có thể
  được gỡ lỗi nếu cần.
- Điều này có thể hữu ích cho các plugin cần phân biệt
  các đối tượng tương tự với nhau (như các đối tượng có cùng tên).

Instance:GetDebugId

scopeLength

Trả về một chuỗi mã hóa của ID gỡ lỗi được sử dụng nội bộ bởi Roblox.

GetDescendants thường được sử dụng để thực hiện một thao tác trên tất cả các hậu duệ là một
loại đối tượng cụ thể. Đoạn mã trong ví dụ này sử dụng GetDescendants và
`Class.Instance:IsA()` để tìm tất cả các phần trong workspace và đổi
them thành màu xanh lá cây.

Phương thức này trả về một mảng chứa tất cả các phần tử con
của đối tượng đó. Không giống như `Class.Instance:GetChildren()`, hàm chỉ trả về
những đứa trẻ trực tiếp của một đối tượng, phương thức này tìm mọi trẻ con của đối tượng,
mỗi trẻ con của những trẻ của chúng, và cứ như vậy.

Instance:GetDescendants

Một mảng chứa các phần tử con của instance.

Trả về một mảng chứa tất cả các phần tử con của instance.

Mẫu mã này trình bày hành vi của `Class.Instance:GetFullName()`. 
Nó cho thấy chức năng hoạt động như thế nào khi được gọi trên một đối tượng không nằm trong 
hệ thống phân cấp `DataModel`, và nó cũng cho thấy giá trị trả về không thoát được 
những ký tự đặc biệt.

Ví dụ mã này tái cài đặt hàm `Class.Instance:GetFullName()` trong
Lua.

Trả về một chuỗi mô tả nguồn gốc của thể hiện. Chuỗi này là một
chuỗi nối của `Class.Instance.Name|Name` của đối tượng và các
tổ tiên của nó, được phân cách bởi các dấu chấm. `Class.DataModel` (`game`) không
được xem xét. Ví dụ, một `Class.Part` trong `Class.Workspace` có thể
trả về `Class.Workspace.Part`.

Khi được gọi trên một `Class.Instance` không phải là một tổ tiên của
`Class.DataModel`, phương thức này xem xét tất cả các tổ tiên lên tới và
gồm tổ tiên tối cao nhất không có `Class.Instance.Parent|Parent`.

Phương thức này hữu ích cho việc ghi lại và gỡ lỗi. Bạn không nên cố gắng
phân tích chuỗi trả về cho bất kỳ hoạt động hữu ích nào; phương thức này không
thoát dấu chấm (hoặc bất kỳ biểu tượng nào khác) trong tên của đối tượng. Nói cách khác,
cho dù đầu ra của nó thường có vẻ như là một định danh Luau hợp lệ, nó không
được đảm bảo.

Instance:GetFullName

Tên đầy đủ của `Class.Instance`.

Trả về một chuỗi mô tả nguồn gốc của instance.

Phương thức này trả về giá trị phong cách hoặc giá trị đã được sửa đổi rõ ràng của thuộc tính đã chỉ định,
hoặc giá trị thuộc tính mặc định nếu nó chưa được phong cách/sửa đổi. Điều này khác một chút so với việc truy cập giá trị thuộc tính
trực tiếp, chẳng hạn như `[GuiObject].Rotation`, mà trả về giá trị mặc định hoặc
đã sửa đổi của thuộc tính.

```lua
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
rule.Selector = "TextButton"

-- Tham chiếu đến một nút
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (giá trị mặc định)
print(button.Rotation) --> 0 (giá trị mặc định)

-- Áp dụng xoay qua thuộc tính quy tắc phong cách
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (giá trị phong cách dựa trên quy tắc)
print(button.Rotation) --> 0 (giá trị mặc định)

-- Sửa đổi/cản trở rõ ràng thuộc tính phong cách
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (giá trị đã sửa đổi)
print(button.Rotation) --> 45 (giá trị đã sửa đổi)
```

Instance:GetStyled

Giá trị phong cách hoặc giá trị đã được sửa đổi rõ ràng của thuộc tính đã chỉ định,
hoặc giá trị thuộc tính mặc định nếu nó chưa được phong cách/sửa đổi.

Trả về giá trị phong cách hoặc giá trị đã được sửa đổi rõ ràng của thuộc tính đã chỉ định,
hoặc giá trị thuộc tính mặc định nếu nó chưa được phong cách/sửa đổi.

Phương thức này trả về một sự kiện mà hoạt động chính xác như sự kiện
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
goài ra chỉ xảy ra khi thuộc tính kiểu cho đã cho thay đổi. Thông thường tốt nhất là sử dụng phương thức này hơn là một kết nối với
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` với một
hàm kiểm tra tên thuộc tính. Các cuộc gọi tiếp theo đến phương thức này trên
cùng một đối tượng với cùng một tên thuộc tính sẽ trả về cùng một sự kiện.

Lưu ý rằng sự kiện này sẽ không truyền bất kỳ tham số nào đến hàm kết nối,
vì vậy giá trị của thuộc tính đã thay đổi phải được đọc trực tiếp trong một
kịch bản.

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("Thuộc tính kiểu đã thay đổi!")
end

meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
```

Instance:GetStyledPropertyChangedSignal

property

Tên thuộc tính kiểu mà bạn muốn lắng nghe các thay đổi.

Sự kiện xảy ra khi thuộc tính kiểu đã cho thay đổi.

Phương thức này trả về một mảng các thẻ đã áp dụng cho instance đã cho, dưới dạng
chuỗi. Bạn có thể thêm thẻ ở cả trong Studio tại
[Properties](/studio/properties) hoặc trong thời gian chạy với
`Class.Instance:AddTag()|AddTag()`.

Phương thức này hữu ích khi bạn muốn làm điều gì đó với nhiều thẻ trên
một instance cùng một lúc. Tuy nhiên, sẽ không hiệu quả khi sử dụng phương thức này để
kiểm tra sự tồn tại của một thẻ duy nhất; thay vào đó, hãy sử dụng
`Class.Instance:HasTag()|HasTag()` để kiểm tra một thẻ cụ thể.

Instance:GetTags

Lấy mảng của tất cả các thẻ đã áp dụng cho instance.

Phương thức này sẽ trả về `true` nếu thẻ cung cấp đã được thêm vào đối tượng.
Bạn có thể thêm thẻ ở cả trong Studio tại
[Properties](/studio/properties) hoặc trong thời gian chạy với
`Class.Instance:AddTag()|AddTag()`.

Instance:HasTag

Kiểm tra xem instance có một thẻ đã cho hay không.

Chứng minh việc xác định xem một thể hiện có phải là tổ tiên của một thể hiện khác hay không bằng cách sử dụng `Class.Instance:IsAncestorOf()`

Workspace và SpawnLocation là tổ tiên của decal của SpawnLocation.
Workspace là tổ tiên của SpawnLocation.

SpawnLocation và decal của nó là con cháu của Workspace, không phải tổ tiên.
Decal là một con cháu của SpawnLocation, không phải tổ tiên.

Trả về true nếu một `Class.Instance` là tổ tiên của phần tử con đã cho.

Một `Class.Instance` được coi là tổ tiên của một đối tượng nếu
`Class.Instance.Parent` của đối tượng hoặc một trong những cha của nó
`Class.Instance.Parent` được thiết lập thành `Class.Instance`.

Xem thêm, `Class.Instance:IsDescendantOf()`.

Instance:IsAncestorOf

Đúng nếu `Class.Instance` là tổ tiên của phần tử con đã cho.

Trả về true nếu một `Class.Instance` là tổ tiên của phần tử con đã cho.

Trả về `true` nếu một `Class.Instance` là phần tử con của tổ tiên đã cho.

Lưu ý rằng `IsDescendantOf()` không thể được sử dụng với tham số là `nil` để
kiểm tra xem một đối tượng có bị loại bỏ hay không.

Xem thêm `Class.Instance:IsAncestorOf()`.

Instance:IsDescendantOf

ancestor

Đối tượng tổ tiên `Class.Instance`.

Đúng nếu `Class.Instance` là phần tử con của tổ tiên đã cho.

Trả về `true` nếu một `Class.Instance` là phần tử con của tổ tiên đã cho.

Phương thức này chỉ ra liệu một thuộc tính cụ thể đã được sửa đổi so với
giá trị mặc định do mã lập trình tạo ra hay không. Nếu được gọi trên một đối tượng mới
được tạo ra thông qua mã (`Datatype.Instance.new()`), phương thức này sẽ trả về `false`. Nếu
được gọi trên một đối tượng mới được tạo ra bởi các quy trình làm việc trong Studio như
gắn kết cửa sổ [Explorer](/studio/explorer), kết quả có thể khác nhau.

Ví dụ, truy vấn thuộc tính
`Class.TextLabel.BackgroundColor3|BackgroundColor3` của một
`Class.TextLabel` được chèn qua [Explorer](/studio/explorer)
 sẽ trả về `true`, nhưng truy vấn thuộc tính cùng một thuộc tính của một `Class.TextLabel`
được tạo ra thông qua `Datatype.Instance.new()` sẽ trả về `false`, giả sử không
thay đổi nào khác được thực hiện đối với
`Class.TextLabel.BackgroundColor3|BackgroundColor3` của nó.

Lưu ý rằng nếu phương thức này trả về `true`, việc tạo kiểu sẽ **không** ảnh hưởng đến
thuộc tính vì việc sửa đổi rõ ràng một thuộc tính sẽ ưu tiên hơn so với việc tạo kiểu cho nó. Để thiết lập lại một thuộc tính về giá trị mặc định do mã lập trình tạo ra và cho phép
tạo kiểu trên nó, hãy sử dụng
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.


Instance:IsPropertyModified

Boolean cho biết liệu thuộc tính đã được sửa đổi so với
giá trị mặc định do mã lập trình tạo ra hay không.


Trả về `true` nếu giá trị lưu trữ trong thuộc tính được chỉ định không bằng
giá trị mặc định do mã lập trình tạo ra.


Đoạn mã sau đây minh họa cách một phần có thể được thêm lại vào DataModel
sau khi bị xóa:

Phương thức này đặt `Class.Instance.Parent` của đối tượng thành `nil`, và làm
tương tự cho tất cả các tổ tiên của nó.

Nếu đối tượng được tham chiếu trước khi bị loại bỏ, có thể
lấy lại đối tượng đó sau này.

Instance:Remove

Đặt `Parent` của đối tượng thành `nil`, và làm tương tự cho tất cả các
phần tử con của nó.

Phương thức này xóa một thẻ khỏi một instance. Nó sẽ không ném ra lỗi nếu
đối tượng không có thẻ. Việc xóa một thẻ thành công sẽ kích hoạt một tín hiệu được tạo bởi
`Class.CollectionService:GetInstanceRemovedSignal()` với thẻ đã cho.

Lưu ý rằng khi gán thẻ cho một instance, thường có một số tài nguyên được sử dụng để
cung cấp chức năng cho thẻ, ví dụ như các kết nối sự kiện hoặc bảng. Để ngăn ngừa rò rỉ bộ nhớ, có một ý tưởng tốt để làm sạch các tài nguyên này
(ngắt kết nối, đặt về `nil`, v.v.) khi không còn cần thiết cho một thẻ.

Instance:RemoveTag

Đặt lại một thuộc tính về giá trị mặc định của nó. Ví dụ, việc gọi
`ResetPropertyToDefault("Rotation")` trên một `Class.TextLabel` tương đương
với việc đặt `Class.TextLabel.Rotation|Rotation` của nó thành `0` (giá trị
mặc định của thuộc tính). Phương thức này có thể được sử dụng để đảm bảo
tính năng kiểu dáng sẽ ghi đè giá trị mặc định của thuộc tính này.

Instance:ResetPropertyToDefault

Tên của thuộc tính cần đặt lại.

Đặt lại một thuộc tính về giá trị mặc định của nó.

Phương thức này đặt thuộc tính với tên đã cho thành giá trị đã cho. Nếu
giá trị được chỉ định là `nil`, thuộc tính sẽ bị xóa, vì `nil` được
trả về theo mặc định.

Ví dụ, đoạn mã sau đây đặt thuộc tính `InitialPosition` của phiên bản thành
`Datatype.Vector3|Vector3.new(0, 10, 0)`:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", Vector3.new(0, 10, 0))
```

##### Giới hạn

Yêu cầu và hạn chế về tên:

- Tên chỉ được sử dụng các ký tự chữ và số.
  - Bạn cũng có thể bao gồm dấu chấm, dấu gạch nối, dấu gạch chéo và dấu gạch dưới.
- Không được phép có khoảng trắng hoặc các ký hiệu đặc biệt (như @, ~, !) trong tên.
- Chuỗi không được quá 100 ký tự.
- Tên không được phép bắt đầu bằng **RBX** trừ khi người gọi là một
  script lõi của Roblox (dành riêng cho Roblox).

Khi cố gắng đặt một thuộc tính thành kiểu không được hỗ trợ, một thông báo lỗi sẽ
xuất hiện.

##### Tham khảo thêm

- `Class.Instance:GetAttribute()` trả về giá trị đã được gán cho thuộc tính đã cho.
- `Class.Instance:GetAttributes()` trả về một từ điển các cặp khóa-giá trị cho từng thuộc tính của phiên bản.

Instance:SetAttribute

Tên của thuộc tính đang được đặt.

value

Giá trị để đặt cho thuộc tính đã chỉ định.

Đặt thuộc tính với tên đã cho thành giá trị đã cho.

Mã sau sẽ chờ một thể hiện có tên "Part" được thêm vào
Workspace.

Trả về đối tượng con của `Class.Instance` với tên đã cho. Nếu đối tượng
con không tồn tại, nó sẽ trì hoãn luồng hiện tại cho đến khi nó tồn tại. Nếu tham số `timeOut` được chỉ định, phương thức này sẽ hết thời gian sau số
giây được chỉ định và trả về `nil`.

##### Sử dụng chính

`Class.Instance:WaitForChild()|WaitForChild()` cực kỳ quan trọng khi
làm việc trên mã chạy bởi client trong `Class.LocalScript`. Engine của Roblox
không đảm bảo thời gian hoặc thứ tự mà các đối tượng được
nhân bản từ máy chủ đến client. Thêm vào đó, nếu một trải nghiệm
có `Class.Workspace.StreamingEnabled` được đặt thành true,
`Class.BasePart|BaseParts` nằm xa khỏi nhân vật của người chơi
có thể không được truyền đến client, có thể gây ra các đoạn mã bị hỏng
khi chỉ số vào các đối tượng chưa tồn tại trên client.

##### Ghi chú

- Phương thức này không trì hoãn nếu một đối tượng con với tên đã cho tồn tại khi
  cuộc gọi được thực hiện.
- `Class.Instance:FindFirstChild()` là một lựa chọn hiệu quả hơn cho
  `Class.Instance:WaitForChild()|WaitForChild()` đối với các đối tượng được
  giả định là tồn tại.
- Nếu một cuộc gọi đến phương thức này vượt quá 5 giây mà không trả về, và không có
  tham số `timeOut` nào được chỉ định, một cảnh báo sẽ được in ra đầu ra rằng luồng có thể trì hoãn vô thời hạn.

Instance:WaitForChild

childName

Tên `Class.Instance.Name` để tìm kiếm.

timeOut

Một tham số thời gian hết hạn tùy chọn.

Trả về đứa trẻ của `Class.Instance` với tên đã cho. Nếu đứa trẻ
không tồn tại, nó sẽ làm tạm dừng luồng hiện tại cho đến khi nó tồn tại.

Hàm children trả về một mảng các trẻ của đối tượng.

Instance:children

Mảng các đối tượng/phiên bản con.

Trả về một mảng các trẻ của đối tượng.

Instance:clone

Instance:destroy

Instance:findFirstChild

Instance:getChildren

Instance:isDescendantOf

Instance:remove

Instance

`Instance` là lớp cơ sở cho tất cả các lớp trong hệ thống lớp của Roblox
có thể là một phần của cây `Class.DataModel`.