TeamCreateData

`Instance` là lớp cơ sở cho tất cả các lớp trong cấu trúc lớp Roblox có thể là phần của cây `Class.DataModel` .

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

Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.

Bắt lửa khi tính chất `Class.Instance.Parent` của đối tượng hoặc một trong những tổ tiên của nó thay đổi.

  Sự kiện này bao gồm hai tham số: `child` ám chỉ đến `Class.Instance` mà `Class.Instance.Parent` thực sự đã được thay đổi, trong khi `parent` ám chỉ đến `Class.Instance.Parent` mới của ví dụ này.

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

Instance.AncestryChanged

child

Các `Class.Instance` của `Class.Instance.Parent` đã được thay đổi.

parent

Cái mới `Class.Instance.Parent` của `Class.Instance` mà `Class.Instance.Parent` đã thay đổi.

Bắt lửa khi tính chất `Class.Instance.Parent` của đối tượng hoặc một trong những tổ tiên của nó thay đổi.

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

  Ví dụ, đoạn mã sau đây kết nối chức năng `attributeChanged()` với bắn khi nào một trong những 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, "changed")
  end

  part.AttributeChanged:Connect(attributeChanged)
  ```

  Xem thêm `Class.Instance:GetAttributeChangedSignal()` mà trả về một sự kiện bắt lửa khi một thuộc tính cụ thể thay đổi.

Instance.AttributeChanged

attribute

Tên thuộc tính đã được thay đổi.

Bắt lửa mỗi khi một thuộc tính được thay đổi trên `Class.Instance`.

This snippet prints the names of objects as they are added to the Workspace:

Lửa sau khi một đối tượng được cha trực tiếp cho đối tượng này `Class.Instance` .

  Lưu ý, khi sử dụng chức năng này trên một khách hàng để phát hiện các đối tượng được tạo bởi máy chủ, cần phải sử dụng `Class.Instance:WaitForChild()` khi lập chỉ mục các con trai của đối tượng này.Điều này là do đối tượng và con cháu của nó không được đảm bảo sao lưu từ máy chủ sang khách hàng cùng một lúc.Ví dụ:

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

  Workspace.ChildAdded:Connect(function(child)
  	-- Use WaitForChild() since descendants may not have replicated yet
  	local head = child:WaitForChild("Head")
  end)
  ```

  Lưu ý, chức năng này chỉ hoạt động cho con cái ngay lập tức của `Class.Instance` . Đối với một chức năng bắt tất cả các con cháu, hãy sử dụng `Class.Instance.DescendantAdded` .

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

Instance.ChildAdded

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

Lửa sau khi một đối tượng được cha trực tiếp cho đối tượng này `Class.Instance` .

This snippet prints the names of objects as they are removed from the
Workspace:

Lửa bùng phát sau khi một đứa trẻ bị loại bỏ khỏi đây `Class.Instance` .

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

  Chức năng này chỉ hoạt động cho con cái ngay lập tức của `Class.Instance` . Đối với một chức năng nắm bắt tất cả các con cháu, sử dụng `Class.Instance.DescendantRemoving` .

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

Instance.ChildRemoved

Các `Class.Instance` đã bị xóa bỏ.

Lửa bùng phát sau khi một đứa trẻ bị loại bỏ khỏi đây `Class.Instance` .

This following example will print the name of any object that is added to the
Workspace:

Sự kiện này bắt lửa sau khi một con cháu được thêm vào `Class.Instance` .

  Khi nó bắn cho mỗi con cháu, nuôi một đối tượng cho `Class.Instance` sẽ bắn sự kiện cho đối tượng này và tất cả con cháu của nó một cách riêng lẻ.

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

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

Instance.DescendantAdded

descendant

Lửa bùng phát sau khi một con cháu được thêm vào `Class.Instance` .

The following example prints the name of any descendant as it is being removed
from the Workspace:

Sự kiện này bắt lửa **ngay lập tức trước** khi cha `Class.Instance` thay đổi như vậy một ví dụ **con trai** sẽ không còn là con trai.`Class.Instance:Destroy()|Destroy()` thay đổi `Class.Instance.Parent|Parent` của một ví dụ thành `nil` , vì vậy gọi phương pháp đó trên con trai của cha sẽ gây ra sự kiện này bắt lửa.

  Vì sự kiện này bắt lửa **trước** khi loại bỏ con cháu, cha của con cháu sẽ không thay đổi tại thời điểm bắn sự kiện này.Nếu con cháu cũng là một đứa con trực tiếp của cha mẹ, sự kiện này sẽ bắn trước khi .

  Nếu con cháu có con, sự kiện này bắt lửa với con cháu trước tiên, sau đó là con cháu của nó.

  ##### Cảnh báo

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

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

  Workspace.DescendantRemoving:Connect(function(descendant)
  	-- Do not manipulate the parent of the descendant in this function!
  	-- This event fires BECAUSE the parent was manipulated, and the change hasn't happened yet
  	-- Therefore, it is problematic to change the parent like this:
  	descendant.Parent = game
  end)

  local part = Instance.new("Part")
  part.Parent = Workspace
  part.Parent = nil
  ```

  Xem thêm `Class.Instance.DescendantAdded|DescendantAdded` .

Instance.DescendantRemoving

Cái `Class.Instance` đang bị xóa bỏ.

Lửa bùng phát ngay lập tức trước khi một con cháu của `Class.Instance` bị xóa bỏ.

This sample demonstrates how, when using Immediate signal behavior, an Instance being destroyed remains in place until the connected function yields.

This sample demonstrates how, when using Deferred signal behavior,
an Instance is destroyed before the signal fires.

The `Class.Instance` sẽ không bao giờ bị xóa khỏi bộ nhớ trong khi chức năng kết nối vẫn đang sử dụng nó.Tuy nhiên, nếu chức năng cho ra ở bất kỳ điểm nào, `Class.Instance` và con cháu của nó sẽ được cha mẹ hóa 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ẽ bắt lửa ngay lập tức trước khi `Class.Instance` hoặc một trong những tổ tiên của nó bị phá hủy với `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ẽ bắt lửa tại điểm tái khởi động tiếp theo, đó sẽ là sau khi `Class.Instance` hoặc một trong các tổ tiên của nó bị phá hủy với `Class.Instance:Destroy()` .

  Với hành vi `Enum.SignalBehavior.Deferred|Deferred` , kết nối một kịch bản vào sự kiện riêng của nó `Class.Instance.Destroying` là khó khăn, vì kịch bản sẽ bị phá hủy trước khi có thể gọi lạ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 bằng tay qua [Explorer](/studio/explorer) hoặc thông qua một plugin, `Class.Instance` không bị phá hủy.Thay vào đó, cha mẹ được đặt thành `nil` mà bạn có thể theo dõi với `Class.Instance.AncestryChanged` .

Instance.Destroying

Lửa bùng phát ngay lập tức trước (hoặc bị trì hoãn cho đến khi) instance bị phá hủy thông qua `Class.Instance:Destroy()` .

Sự kiện này bắt lửa khi bất kỳ thuộc tính phong cách nào được thay đổi trên instance, bao gồm cả khi 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("Styled properties changed")
  end

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

Instance.StyledPropertiesChanged

Bắt lửa mỗi khi bất kỳ thuộc tính phong cách nào được thay đổi trên instance, bao gồm cả khi thuộc tính được đặt thành `nil` .

Instance.childAdded

Phương pháp này áp dụng một thẻ cho instance, không có hiệu lực nếu thẻ đã được áp dụng.Thành công thêm một thẻ 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 ví dụ được thêm bởi phía khách sẽ bị xóa nếu máy chủ sau đó thêm hoặc xóa một thẻ trên ví dụ đó vì máy chủ sao chép tất cả các thẻ cùng nhau và thay thế các thẻ trước.

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

Instance:AddTag

Chức năng này phá hủy tất cả con và con cháu của một ví dụ.

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

  -- Add some sparkles
  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 phá hủy **tất cả** con cháu và con cháu, hãy sử dụng `Class.Instance:GetChildren()` hoặc `Class.Instance:GetDescendants()` để lặp qua những con cháu/con cháu đó và chọn những gì cần phá hủy.Ví dụ, mã trình bày sau đây sẽ phá hủy tất cả các `Class.BasePart|BaseParts` xuống 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

Chức năng này phá hủy tất cả con của một ví dụ.

Demonstrates cloning a model using `Class.Instance:Clone()`.

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

  Nếu một thuộc tính tham chiếu như `Class.ObjectValue.Value` được đặt trong một ví dụ được sao chép, giá trị của thuộc tính sao chép phụ thuộc vào giá trị gốc:

  *   Nếu một thuộc tính tham chiếu đề cập đến một ví dụ đã **cũng** được sao chép, bản sao sẽ đề cập đến bản sao.
  *   Nếu một thuộc tính tham chiếu đề cập đến một đối tượng đã không **bị sao chép** , giá trị tương tự được duy trì trong bản sao.

Instance:Clone

Tạo bản sao của một ví dụ và tất cả con cháu của nó, bỏ qua các ví dụ không phải `Class.Instance.Archivable|Archivable` .

Minh họa việc phá hủy một phần bằng chức năng `Class.Instance:Destroy()`.

  Chức năng này là cách đúng để loại bỏ các đối tượng không còn được yêu cầu.

Đặt thuộc tính `Class.Instance.Parent` thành `nil` , khóa thuộc tính `Class.Instance.Parent` , cắt tất cả các kết nối, và gọi `Destroy()` trên tất cả các con.Chức năng này là cách đúng để loại bỏ các đối tượng không còn được yêu cầu.

  Loại bỏ 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 lượ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 tốt nhất sau khi gọi `Destroy()` trên một đối tượng, đặt bất kỳ biến nào tham chiếu đối tượng (hoặc con cháu của nó) thành `nil` .Điều này ngăn chặn mã của bạn không truy cập bất cứ thứ gì liên quan đến đối tượng.

  ```lua
  local part = Instance.new("Part")
  part.Name = "Hello, world"
  part:Destroy()
  -- Không làm như vậy:
  print(part.Name)  --> "Xin chào, thế giới"
  -- Làm điều này để ngăn chặn dòng trên không hoạt động:
  part = nil
  ```

  Một lần `Class.Instance` đã bị phá hủy bởi phương pháp này, nó không thể được sử dụng lại vì thuộc tính `Class.Instance.Parent` bị khóa.Để **tạm thời** loại bỏ một đối tượng thay vì phá hủy nó, hãy đặt `Class.Instance.Parent|Parent` để `nil` .Ví dụ:

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

  object.Parent = nil
  task.wait(2)
  object.Parent = Workspace
  ```

  Để phá hủy một đối tượng sau một khoảng thời gian nhất định, 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` , cắt tất cả các kết nối, và gọi `Destroy()` trên tất cả các con.

Trả về tổ tiên đầu tiên của `Class.Instance` người có `Class.Instance.Name` bằng tên được cung cấp.

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

  Các đoạn mã sau đây sẽ tìm thấy tổ tiên đầu tiên của đối tượng có tên là `Car`.

  ```
  local car = object:FindFirstAncestor("Car")
  ```

  Đối với các biến thể của chức năng này tìm tổ tiên của một lớp cụ thể, xem `Class.Instance:FindFirstAncestorOfClass()` và `Class.Instance:FindFirstAncestorWhichIsA()` .

Instance:FindFirstAncestor

name

Cái `Class.Instance.Name` để tìm kiếm.

The `Class.Instance` được tìm thấy.

Trả về tổ tiên đầu tiên của `Class.Instance` người có `Class.Instance.Name` bằng tên được cung cấp.

Trả về tổ tiên đầu tiên của `Class.Instance` người có `Class.Object.ClassName` bằng với className đã được cung cấp.

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

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

  ```
  local model = part:FindFirstAncestorOfClass("Model")
  ```

  Chức năng này là một biến thể của `Class.Instance:FindFirstAncestor()` mà kiểm tra thuộc tính `Class.Object.ClassName` thay vì `Class.Instance.Name` .`Class.Instance:FindFirstAncestorWhichIsA()` cũng tồn tại, sử dụng phương pháp `Class.Object:IsA()` thay vì tôn trọng sự kế thừa lớp.

Instance:FindFirstAncestorOfClass

className

Cái `Class.Object.ClassName` để tìm kiếm.

Trả về tổ tiên đầu tiên của `Class.Instance` người có `Class.Object.ClassName` bằng với className đã được cung cấp.

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

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

  Không giống như `Class.Instance:FindFirstAncestorOfClass()` , chức năng này sử dụng `Class.Object:IsA()` mà tuân thủ kế thừa lớp. Ví dụ:

  ```
  print(part:IsA("Part"))  --> true
  print(part:IsA("BasePart"))  --> true
  print(part:IsA("Instance"))  --> true
  ```

  Do đó, mẫu mã code sau đây sẽ trả về tổ tiên đầu tiên `Class.BasePart` , bất kể nó là một `Class.WedgePart` , `Class.MeshPart` hoặc `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` cho người mà `Class.Object:IsA()` trả về true cho className đã cho.

The below would look in Workspace for an object name "Brick". If found, it
will change the name of the object to "Foo".

Trả về con đầu tiên của `Class.Instance` với tên đã cho, hoặc `nil` nếu không có con như vậy.Nếu tham số tùy chọn `recursive` không bắt buộc là `true` , chức năng này tìm kiếm tất cả các con trai thay vì chỉ con cái gần 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 con theo tên bằng cách sử dụng phép tính dấu chấm câu ném lỗi nếu con không tồn tại.

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

  -- Các lỗi dòng tiếp theo nếu phần không tồn tại trong không gian làm việc
  Workspace.Part.Transparency = 0.5
  ```

  Một tiếp cận tốt hơn là sử dụng `FindFirstChild()` để kiểm tra trước tiên `Part` , sau đó sử dụng một tuyên bố `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 đứa trẻ có tên phù hợp với một thuộc tính

  Đôi khi `Class.Instance.Name|Name` của một đối tượng giống như của một tính năng của nó `Class.Instance.Parent|Parent` .Khi sử dụng phép tính dấu chấm câu, các thuộc tính có ưu tiên hơn các con trong trường hợp chúng chia sẻ tên.

  Trong ví dụ sau, một `Class.Folder` được gọi `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` đề cập đến giá trị thuộc tính `Datatype.Color3` , không phải là ví dụ con `Class.Folder` .Lợi ích của việc sử dụng `Class.Instance:FindFirstChild()|FindFirstChild()` là việc giới thiệu các thuộc tính mới không gây 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")  -- The child folder
  ```

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

  `Class.Instance:FindFirstChild()|FindFirstChild()` mất khoảng 20% lâu hơn so với việc sử dụng phép tính dấu chấm câu và gần 8 lần lâu hơn so với việc chỉ lưu 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 vòng lặp chặt chẽ hoặc chức năng kết nối với `Class.RunService.Heartbeat` và `Class.RunService.PreRender` .Thay vào đó, 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 đứa con của một tên nhất định trở nên có sẵn.

Instance:FindFirstChild

The `Class.Instance.Name` để tìm kiếm.

recursive

Liệu có nên thực hiện tìm kiếm theo cấp chồng hay không.

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

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

Instance:FindFirstChildOfClass

Trả về con đầu tiên của `Class.Instance` có `Class.Object.ClassName|ClassName` bằng tên lớp đã cho.

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

  Nếu không tìm thấy con trùng khớp, chức năng này trả về `nil` .Nếu tham số lặp lại bắt buộc là true, chức năng này tìm kiếm tất cả các con trai thay vì chỉ con cái ngay lập tức của `Class.Instance` .

  Không giống như `Class.Instance:FindFirstChildOfClass()` , chức năng này sử dụng `Class.Object:IsA()` mà tuân thủ kế thừa lớp. Ví dụ:

  ```lua
  print(part:IsA("Part")) --> thật
  print(part:IsA("BasePart")) --> thật
  print(part:IsA("Instance")) --> true
  ```

  Do đó, mẫu mã code sau đây sẽ trả về đứa con thứ nhất `Class.BasePart` , bất kể nó là một `Class.WedgePart` , `Class.MeshPart` hoặc `Class.Part` .

  ```
  local part = object:FindFirstChildWhichIsA("BasePart")
  ```

  Các nhà phát triển tìm kiếm một đứa trẻ bằng tên, nên sử dụng `Class.Instance:FindFirstChild()` thay thế.

Instance:FindFirstChildWhichIsA

The `Class.Object.ClassName` để tìm kiếm.

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

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

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

Instance:FindFirstDescendant

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

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

Instance:GetActor

Trả về `Class.Actor` liên quan đến Instances, nếu có.

Phương pháp 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 được cung cấp thành giá trị được cho.
  *   `Class.Instance:GetAttributes()` trả về một từ điển các cặp chìa khóa-giá trị cho mỗi thuộc tính của một ví dụ.

Instance:GetAttribute

Tên của thuộc tính được truy xuất.

Giá trị đã được gán cho tên thuộc tính đã được cung cấp. 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.

Chức năng này trả về một sự kiện có hành vi tương tự như sự kiện `Class.Object.Changed|Changed` nhưng chỉ bắn khi có sự thay đổi cụ thể về thuộc tính; hiệu quả nó tương tự với `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` nhưng đối với các thuộc tính.

  Nói chung, đây là một ý tưởng tốt để sử dụng phương pháp này thay vì kết nối với `Class.Object.Changed|Changed` với một chức năng kiểm tra tên thuộc tính.Các cuộc gọi tiếp theo đến phương pháp này trên cùng một đối tượng với cùng tên thuộc tính trả về cùng một sự kiện.

  Ví dụ mã sau đây trả về một tín hiệu kích hoạt chức năng `attributeChanged()` khi thuộc tính phần `InitialPosition` thay đổi:

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

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

  local function attributeChanged()
  	print("Attribute changed")
  end

  part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
  ```

  Xem thêm `Class.Instance.AttributeChanged` nơi bắn bất cứ khi nào bất kỳ thuộc tính nào được thay đổi trên instance.

Instance:GetAttributeChangedSignal

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

Một sự kiện bắt lửa khi đặc tính được cung cấp thay đổi.

Trả về một sự kiện bắt lửa khi đặc tính được cung cấp thay đổi.

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

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

  ```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()` đó trả về giá trị đã được gán cho tên thuộc tính đã cho.

Instance:GetAttributes

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

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

The below would print the name of all objects currently in Workspace when ran.

Trả về một array (một bảng được đánh số theo số thập phân) chứa tất cả con trực tiếp của instance, hoặc mỗi `Class.Instance` mà địa chỉ `Class.Instance.Parent|Parent` của nó bằng với object.Mảng có thể được lặp lại khi sử dụng một vòng lặp số hoặc chung:

  ```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 .. " is child number " .. i)
  end
  ```

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

  -- Ví dụ vòng lặp chung
  local children = Workspace:GetChildren()
  for i, child in children do
  	print(child.Name .. " is child number " .. i)
  end
  ```

  Các con trẻ được sắp xếp theo thứ tự mà thuộc tính `Class.Instance.Parent|Parent` của chúng được đặt vào đối tượng.

  Xem thêm chức năng `Class.Instance:GetDescendants()|GetDescendants` .

Instance:GetChildren

Trả về một array chứa tất 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:

  *   Vật phẩm 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.
  *   Một ID gỡ lỗi là một ID được sử dụng trong quá trình gỡ lỗi.Nó cho phép một trình gỡ lỗi đọc mỗi lệnh trước khi ứng dụng xử lý nó.Tất cả các đối tượng trong Roblox hoạt động như các quy trình và mỗi lệnh chạy (hoặc 'mã') có thể được gỡ lỗi nếu cần thiết.
  *   Đ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ã của ID gỡ lỗi được sử dụng nội bộ bởi Roblox.

GetDescendants is often used to do something to all the descendants that are a
particular type of object. The code in this example uses GetDescendants and
`Class.Instance:IsA()` to find all of the parts in the workspace and turns
them green.

Phương pháp đối tượng này trả về một array chứa tất cả các con trai của đối tượng đó.Không giống như `Class.Instance:GetChildren()`, chỉ trả về con cái ngay lập tức của một đối tượng, phương pháp này tìm tất cả con cái của đối tượng, tất cả con cái của những con cái đó, và như vậy.

Instance:GetDescendants

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

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

This code sample demonstrates the behavior of `Class.Instance:GetFullName()`.
It shows how the function behaves when called on an object not in the
`DataModel` hierarchy, and it also shows how the return value does not escape
special characters.

This code sample re-implements the `Class.Instance:GetFullName()` function in
Lua.

Trả về một chuỗi mô tả nguồn gốc của instance.Chuỗi là sự kết hợp của `Class.Instance.Name|Name` của đối tượng và tổ tiên của nó, được tách bởi dấu chấm câu.The `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 gọi trên một `Class.Instance` không phải là con cháu của `Class.DataModel` , chức năng này xem xét tất cả các tổ tiên lên tới và bao gồm tổ tiên cao nhất mà không có `Class.Instance.Parent|Parent` .

  Chức năng 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; chức năng này không thoát khỏi các khoảng trống (hoặc bất kỳ biểu tượng nào khác) trong tên đối tượng.Nói cách khác, mặc dù đầu ra của nó thường xuất hiện là một nhận dạng 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 pháp này trả về giá trị có định dạng hoặc đã được thay đổi rõ ràng của thuộc tính được chỉ định, hoặc giá trị thuộc tính mặc định nếu nó chưa được thiết kế/thay đổi.Điều này khác một chút so với việc truy cập giá trị tài sản trực tiếp, chẳng hạn như `[GuiObject].Rotation` , trả về giá trị mặc định hoặc đã điều chỉnh của tài sản.

  ```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 thông qua tính năng của quy tắc phong cách
  rule:SetProperty("Rotation", 30)

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

  -- Sửa đổi/thay thế công bố có phong cách rõ ràng
  button.Rotation = 45

  print(button:GetStyled("Rotation")) --> 45 (giá trị đã điều chỉnh)
  print(button.Rotation) --> 45 (modified value)
  ```

Instance:GetStyled

Tên của thuộc tính để truy vấn.

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

Trả giá trị có định dạng hoặc được sửa đổi cụ thể của thuộc tính được chỉ định, hoặc giá trị thuộc tính mặc định nếu nó chưa được định dạng/sửa đổi.

Phương pháp này trả về một sự kiện có hành vi tương tự như sự kiện `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`, ngoại trừ việc nó chỉ bắn khi thuộc tính kiểu được thay đổi.Nói chung, đây là một ý tưởng tốt để sử dụng phương pháp này thay vì kết nối với `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` với một chức năng kiểm tra tên tài sản.Các cuộc gọi tiếp theo đến phương pháp này trên cùng một đối tượng với cùng tên thuộc tính 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 chức năng 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("Style property changed!")
  end

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

Instance:GetStyledPropertyChangedSignal

property

Tên của thuộc tính phong cách để nghe thay đổi.

Sự kiện bắt lửa khi thuộc tính phong cách được cung cấp thay đổi.

Phương pháp này trả về một danh sách các thẻ được áp dụng cho ví dụ được cho, dưới dạng chuỗi.Bạn có thể thêm thẻ vào Studio trong cửa sổ [Tính năng](/studio/properties) hoặc tại thời gian chạy với `Class.Instance:AddTag()|AddTag()` .

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

Instance:GetTags

Nhận một array của tất cả các thẻ được áp dụng cho instance.

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

Instance:HasTag

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

Demonstrates determining if one instance is the ancestor of another using `Class.Instance:IsAncestorOf()`

Workspace and SpawnLocation are ancestors of the SpawnLocation's decal.
Workspace is an ancestor of SpawnLocation.

SpawnLocation and its decal are descendants of Workspace, not ancenstors.
Decal is a descendant to SpawnLocation, not an ancestor.

Trả về true nếu một `Class.Instance` là tổ tiên của con cháu được cho.

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

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

Instance:IsAncestorOf

Những người con trai `Class.Instance` .

Đúng nếu `Class.Instance` là tổ tiên của con cháu được cho.

Trả về true nếu một `Class.Instance` là tổ tiên của con cháu được cho.

Trả về `true` nếu một `Class.Instance` là con cháu của tổ tiên được cho.

  Lưu ý rằng `IsDescendantOf()` không thể được sử dụng với một tham số của `nil` để kiểm tra xem một đối tượng đã bị xóa hay chưa.

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

Instance:IsDescendantOf

ancestor

Đúng nếu `Class.Instance` là con cháu của tổ tiên được cho.

Trả về `true` nếu một `Class.Instance` là con cháu của tổ tiên được cho.

Trả về `true` nếu giá trị được lưu trong thuộc tính được chỉ định bằng giá trị mặc định được khởi tạo bởi mã Ví dụ, nếu xuất thuộc tính của một cho thấy , thì gọi trên nhãn sẽ trả về bởi vì là giá trị mặc định cho khi nhãn được tạo thông qua công việc chỉnh sửa Studio thay vì được chèn qua công việc chỉnh sửa Studio.

  Lưu ý rằng nếu phương pháp này trả về `true` , phong cách 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 có ưu tiên hơn so với việc phong cách nó.

Instance:IsPropertyModified

Boolean chỉ ra xem liệu tính năng có bị thay đổi hay không.

Trả về `true` nếu giá trị được lưu trong thuộc tính được chỉ định bằng giá trị mặc định được khởi tạo bởi mã

The following code demonstrates how a part can be re-added to the DataModel
after being removed:

Chức năng này đặt đối tượng của `Class.Instance.Parent` đến `nil` , và làm tương tự cho tất cả các con trai của nó.

  Nếu đối tượng được tham chiếu trước khi bị xóa, bạn có thể lấy lại đối tượng tại một thời điểm sau.

Instance:Remove

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

Phương pháp này xóa một thẻ từ một ví dụ.Nó sẽ không phát ra lỗi nếu đối tượng không có thẻ.Loại bỏ thành công một thẻ 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 đánh dấu một ví dụ, thông thường một số tài nguyên được sử dụng để cung cấp cho nhãn chức năng của nó, ví dụ như kết nối sự kiện hoặc bảng.Để ngăn chặn rò rỉ bộ nhớ, một ý tưởng tốt là dọn sạch chúng (cắt kết nối, đặt thành `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ụ, gọi `ResetPropertyToDefault("Rotation")` trên `Class.TextLabel` là tương đương với việc đặt giá trị `Class.TextLabel.Rotation|Rotation` của nó thành `0` (giá trị mặc định của thuộc tính).Phương pháp này có thể được sử dụng để đảm bảo rằng phong cách sẽ thay thế giá trị mặc định của thuộc tính này.

Instance:ResetPropertyToDefault

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

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

Phương pháp này đặt thuộc tính với tên được cung cấp cho giá trị được cho.Nếu giá trị được cung cấp là `nil` , thuộc tính sẽ bị xóa, vì `nil` được trả lại theo mặc định.

  Ví dụ, đoạn mã sau đây thiết lập thuộc tính `InitialPosition` của instance 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))
  ```

  ##### Hạn chế

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

  *   Tên chỉ được sử dụng các ký tự alphanumeric và dấu gạch ngang.
  *   Không có không gian hoặc biểu tượng duy nhất được phép.
  *   Chuỗi phải là 100 ký tự hoặc ít hơn.
  *   Các tên không được phép bắt đầu với **RBX** trừ khi người gọi là một kịch bản lõi Roblox (dành riêng cho Roblox).

  Khi cố gắng đặt một thuộc tính cho một loại không được hỗ trợ, một lỗi sẽ được ném.

  ##### Xem thêm

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

Instance:SetAttribute

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

value

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

Đặt thuộc tính với tên được cung cấp thành giá trị được cho.

The following code waits for an instance named "Part" to be added to
Workspace.

Trả về con của `Class.Instance` với tên được cung cấp.Nếu con không tồn tại, nó sẽ cho ra luồng hiện tại cho đến khi nó làm.Nếu tham số `timeOut` được xác định, phương pháp này sẽ hết giờ sau số giây được xác định và trả về `nil` .

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

  `Class.Instance:WaitForChild()|WaitForChild()` rất quan trọng khi làm việc trên mã được thực hiện bởi khách hàng trong một `Class.LocalScript` .Cơ chế Roblox không đảm bảo thời gian hoặc thứ tự mà các đối tượng được sao lưu từ máy chủ sang khách hàng.Ngoài ra, nếu một trải nghiệm có `Class.Workspace.StreamingEnabled` được đặt thành true, `Class.BasePart|BaseParts` những thứ ở xa nhân vật của người chơi có thể không được phát lên máy khách, có thể gây ra lỗi khi lập chỉ mục các đối tượng chưa tồn tại trên máy khách.

  ##### Ghi chú

  *   Chức năng này không trả nếu có một đứa con với tên đã cho 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 cho là tồn tại.
  *   Nếu cuộc gọi đến phương thức này vượt quá 5 giây mà không trả lại, và không có tham số `timeOut` được đặt, một cảnh báo sẽ được in vào đầu ra mà luồng có thể sản xuất vô cực.

Instance:WaitForChild

childName

timeOut

Trả về con của `Class.Instance` với tên được cung cấp. Nếu con không tồn tại, nó sẽ tạo luồng hiện tại cho đến khi nó làm.

Chức năng con trả về một array các con của đối tượng.

Instance:children

Mảng các đối tượng/instances con.

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

Instance:clone

Instance:destroy

Instance:findFirstChild

Instance:getChildren

Instance:isDescendantOf

Instance:remove

Instance

Tính chất này xác định xem liệu instance có nên được bao gồm khi kinh nghiệm được xuất bản hoặc lưu hoặc khi `Class.Instance:Clone()|Clone()` được gọi trên một trong những tổ tiên của instance.Gọi trực tiếp trên một ví dụ sẽ trả về nếu ví dụ đó không là .

  Bản sao một đối tượng trong Studio bằng cách sử dụng Sao chép hoặc Sao chép / Dán lựa chọn sẽ bỏ qua chính sở hữu của nó và đặt cho bản sao.

  ```
  local part = Instance.new("Part")
  print(part:Clone())  --> Part
  part.Archivable = false
  print(part:Clone())  --> nil
  ```

Instance.Archivable

Xác định xem một `Class.Instance` và con cháu của nó có thể được nhân bản bằng cách sử dụng `Class.Instance:Clone()` và có thể được lưu/xuất bản.

Bộ năng lực được phép sử dụng cho các kịch bản bên trong ví dụ này.Để các khả năng có hiệu lực, `Class.Instance.Sandboxed` tính năng phải được bật.

  Thuộc tính này được sử dụng bởi một tính năng thử nghiệm. Xem [khả năng kịch bản](/scripting/capabilities) để biết thêm chi tiết.

Instance.Capabilities

Bộ năng lực được phép sử dụng cho các kịch bản bên trong thùng chứa này.

Một nhận dạng không duy nhất của `Class.Instance` . Danh sách được sử dụng để giữ cho cấu trúc hệ thống đối tượng được tổ chức, cùng với việc cho phép các tập lệnh truy cập các đối tượng cụ thể.Tên của một instanz không thể vượt quá 100 ký tự về kích thước.

  Tên của một đối tượng thường được sử dụng để truy cập đối tượng thông qua cấu trúc hệ thống dữ liệu bằng các phương pháp sau:

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

  local baseplate = Workspace.Baseplate
  local baseplate = Workspace["Baseplate"]
  local baseplate = Workspace:FindFirstChild("BasePlate")
  ```

  Để làm cho một đối tượng có thể truy cập bằng cách sử dụng dấu chấm tròn ( `.` ), tên của nó phải bắt đầu bằng một dấu gạch ngang hoặc chữ cái, và phần còn lại của tên chỉ có thể chứa chữ cái, số hoặc dấu gạch ngang (không có các ký tự đặc biệt khác).Nếu tên của một đối tượng không tuân theo cú pháp này, nó sẽ không thể truy cập bằng cách sử dụng phép tính dot và Luau sẽ không hiểu tên của nó như một nhận dạng.

  Nếu nhiều hơn một đối tượng có cùng tên là anh em, bất kỳ nỗ lực nào để lập chỉ mục một đối tượng bằng cùng tên sẽ trả về chỉ một trong những đối tượng, tương tự như `Class.Instance:FindFirstChild()`, nhưng không phải lúc nào cũng là đối tượng mong muốn.Nếu một đối tượng cụ thể cần được truy cập thông qua mã, nó được khuyến khích để cho nó một tên duy nhất hoặc đảm bảo rằng không có anh em nào của nó chia sẻ cùng một tên.

  Xem thêm `Class.Instance:GetFullName()` để có được tên đầy đủ bao gồm cấu trúc của đối tượng.

Instance.Name

Một nhận dạng không duy nhất của `Class.Instance` .

Thuộc tính `Parent` xác định cha cấp bậc của `Class.Instance` .Các thuật ngữ sau đây được sử dụng phổ biến khi nói về cách thiết lập tính năng này:

  *   Một đối tượng là một con trai của, hoặc là bị cha mẹ , một đối tượng khác khi đối tượng của nó được đặt thành đối tượng đó.

  *   Các **con cháu** của một `Class.Instance` là con của đối tượng đó, cộng với con cháu của con cái cũng như vậy.

  *   Các **tổ tiên** của một `Class.Instance` là tất cả các đối tượng mà instance là con cháu.

  Nó là từ thuộc tính `Parent` của nhiều thành viên API khác nhận tên của họ, chẳng hạn như `Class.Instance:GetChildren()|GetChildren()` và `Class.Instance:FindFirstChild()|FindFirstChild()` .Tính năng này cũng được sử dụng để quản lý xem một đối tượng có tồn tại trong trải nghiệm hay cần phải bị xóa.Miễn là cha của một đối tượng ở trong `Class.DataModel` , được lưu trong một biến hoặc được tham chiếu bởi thuộc tính của đối tượng khác, đối tượng vẫn còn trong trải nghiệm; nếu không, đối tượng sẽ tự động bị xóa.

  Gọi `Class.Instance:Destroy()|Destroy()` sẽ đặt `Parent` của một `Class.Instance` và tất cả con cháu của nó thành `nil` và cũng **khóa** tính chất `Parent`.Một lỗi được nâng lên khi đặt `Parent` của một đối tượng bị phá hủy.

  Các đối tượng được tạo mới bằng cách sử dụng `Datatype.Instance.new()` sẽ không có cha, và thường sẽ không hiển thị hoặc chức năng cho đến khi một được đặt.

  ##### Sao lưu đối tượng

  Một đối tượng được tạo bởi máy chủ sẽ không sao chép cho khách hàng cho đến khi nó được gán cho một đối tượng được sao chép.Khi tạo một đối tượng và đặt nhiều thuộc tính, được khuyến khích đặt thuộc tính `Parent` **cuối cùng** .Điều này đảm bảo vật phẩm sao lưu một lần, thay vì sao lưu nhiều thay đổi tính năng.

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

  -- Chỉnh sửa cha của ví dụ mới cuối cùng (được đề xuất)
  local part = Instance.new("Part")
  part.Position = Vector3.new(0, 10, 0)
  part.Parent = Workspace
  ```

  Tuy nhiên, nếu phần cha cho một `Class.Model` mà cha của nó chưa được đặt, việc cha từng phần cho mô hình đó là có thể chấp nhận vì mô hình sẽ không được sao chép.

Instance.Parent

Xác định cha cấp bậc của `Class.Instance` .

Thuộc tính này đã được sử dụng để bảo vệ các đối tượng trong dịch vụ `Class.CoreGui` không bị thay đổi bởi người dùng theo cách không được phép.Nó đã bị lỗi thời và không làm gì cả.

Instance.RobloxLocked

Một tính năng lỗi thời đã từng được sử dụng để bảo vệ `Class.CoreGui` các đối tượng.

`Instance` là lớp cơ sở cho tất cả các lớp trong cấu trúc lớp Roblox có thể là phần của cây `Class.DataModel` .

/reference/engine/classes/TeamCreateData.yaml

TeamCreateData

Tóm Tắt

Thuộc Tính

Phương Pháp

Sự Kiện

Thuộc Tính

Phương Pháp

Sự Kiện

Trên trang này