Ein interner Dienst, der für das Verhalten von `Class.SpawnLocation|SpawnLocations` verantwortlich ist. Seine Funktionalität ist nicht für Entwickler zugänglich.

SpawnerService

`Instance` ist die Basisklasse für alle Klassen in der Roblox-Klassenpyramide, die Teil des `Class.DataModel` Baums sein können.

  Es ist nicht möglich, direkt Wurzel `Instance` Objekte zu erstellen, aber der spezielle `Datatype.Instance.new()` Konstruktor erstellt Objekte über Code, nimmt den Namen der Klasse als Parameter und gibt das erstellte Objekt zurück.

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.

Feuert, wenn die `Class.Instance.Parent` Eigenschaft des Objekts oder eine seiner Vorfahren geändert wird.

  Dieses Ereignis enthält zwei Parameter: `child` bezieht sich auf die `Class.Instance` , deren `Class.Instance.Parent` tatsächlich geändert wurde, während `parent` sich auf die neue Instanz von `Class.Instance.Parent` bezieht.

  Du kannst dieses Ereignis verwenden, um die Löschung einer Instanz in Studio zu verfolgen, z. B. manuelle Löschung im Explorer oder durch ein Plugin.Wenn du feststellen musst, wann eine Instanz mit `Class.Instance:Destroy()` zerstört wird, verwende stattdessen das `Class.Instance.Destroying` -Ereignis.

Instance.AncestryChanged

child

Die `Class.Instance`, deren `Class.Instance.Parent` geändert wurde.

parent

Das neue `Class.Instance.Parent` der `Class.Instance`, dessen `Class.Instance.Parent` geändert wurde.

Feuert, wenn die `Class.Instance.Parent` Eigenschaft des Objekts oder eine seiner Vorfahren geändert wird.

Dieses Ereignis wird immer dann ausgelöst, wenn ein Attribut auf der Instanz geändert wird, einschließlich dann, wenn ein Attribut auf `nil` gesetzt wird.Der Name des geänderten Attributes wird an die verbundene Funktion übergeben.

  Zum Beispiel verbindet das folgende Code-Snippet die `attributeChanged()`-Funktion, die immer dann abgefeuert wird, wenn eines der Attributen des Teils geändert wird:

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

  local part = Workspace.Part

  local function attributeChanged(attributeName)
  	print(attributeName, "changed")
  end

  part.AttributeChanged:Connect(attributeChanged)
  ```

  Siehe auch `Class.Instance:GetAttributeChangedSignal()`, das ein Ereignis zurückgibt, das abgefeuert wird, wenn ein bestimmtes gegebenes Attribut geändert wird.

Instance.AttributeChanged

attribute

Der Name des Attributs, das geändert wurde.

Feuert immer dann, wenn ein Attribut auf der `Class.Instance` geändert wird.

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

Feuert nachdem ein Objekt diesem `Class.Instance` zugewiesen wurde.

  Beachten Sie, wenn Sie diese Funktion auf einem Client verwenden, um Objekte, die vom Server erstellt wurden, zu erkennen, ist es notwendig, `Class.Instance:WaitForChild()` zu verwenden, wenn Sie die Nachkommen dieser Objekte indexieren.Das liegt daran, dass das Objekt und seine Nachkommen nicht garantiert werden, gleichzeitig vom Server auf den Client zu replizieren.Zum Beispiel:

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

  Beachten Sie, dass diese Funktion nur für unmittelbare Kinder des `Class.Instance` funktioniert. Für eine Funktion, die alle Nachkommen einfängt, verwenden Sie `Class.Instance.DescendantAdded` .

  Siehe auch `Class.Instance.ChildRemoved`.

Instance.ChildAdded

Das `Class.Instance`, das hinzugefügt wurde.

Feuert nachdem ein Objekt diesem `Class.Instance` zugewiesen wurde.

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

Feuert nachdem ein Kind von diesem `Class.Instance` entfernt wurde.

  Entfernt bezieht sich darauf, wenn der Eltern eines Objekts von diesem `Class.Instance` auf etwas anderes geändert wird als dies `Class.Instance`.Beachten Sie, dass dieses Ereignis auch ausgelöst wird, wenn ein Kind zerstört wird (unter Verwendung von `Class.Instance:Destroy()` ), da die Zerstörungsfunktion den Eltern eines Objekts auf `nil` festlegt.

  Diese Funktion funktioniert nur für unmittelbare Kinder des `Class.Instance`. Für eine Funktion, die alle Nachkommen erfasst, verwende `Class.Instance.DescendantRemoving` .

  Siehe auch `Class.Instance.ChildAdded`.

Instance.ChildRemoved

Das `Class.Instance`, das entfernt wurde.

Feuert nachdem ein Kind von diesem `Class.Instance` entfernt wurde.

Das folgende Beispiel druckt den Namen eines jeden Objekts aus, das zum Arbeitsbereich hinzugefügt wird:

Dieses Ereignis wird ausgelöst, nachdem ein Abkömmling dem `Class.Instance` hinzugefügt wurde.

  Da es für jeden Nachkommen feuert, wird das Eltern eines Objekts für dieses Objekt und alle seine Nachkommen einzeln das Ereignis auslösen.

  Wenn Sie sich nur um die **direkten Kinder** der `Class.Instance` kümmern, verwenden Sie stattdessen `Class.Instance.ChildAdded`.

  Siehe auch `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Feuert nachdem ein Nachkomme zum `Class.Instance` hinzugefügt wurde.

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

Dieses Ereignis wird **sofort vor** dem Eltern-`Class.Instance` ausgelöst, sodass eine **Nachkomme-Instanz** nicht mehr eine Nachkomme ist. `Class.Instance:Destroy()|Destroy()` ändert eine Instanz' `Class.Instance.Parent|Parent` zu `nil`, so dass das Aufrufen dieser Methode auf einem Nachkommen des Vaters dazu führt, dass dieses Ereignis ausgelöst wird.

  Da dieses Ereignis **vor dem Entfernen des Nachkommens** feuert, bleibt der Elternteil des Nachkommens bei der Zeit des Feuern dieses Ereignisses unverändert.Wenn der Nachkomme auch ein direktes Kind des Elternteils ist, wird dieses Ereignis vor abgefeuert.

  Wenn ein Nachkomme Kinder hat, feuert dieses Ereignis zuerst mit dem Nachkommen, gefolgt von seinen Nachkommen.

  ##### Warnung

  Dieses Ereignis wird mit dem abstehenden Objekt abgefeuert, das entfernt wird.Versuche, die `Class.Instance.Parent|Parent` des Nachkommen auf etwas anderes zu setzen, werden fehlschlagen.Das folgende Beispiel zeigt dies:

  ```
  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
  ```

  Siehe auch `Class.Instance.DescendantAdded|DescendantAdded`.

Instance.DescendantRemoving

Feuert sofort, bevor ein Nachkomme der `Class.Instance` entfernt wird.

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.

Die `Class.Instance` wird niemals aus dem Speicher gelöscht, während eine verbundene Funktion sie noch verwendet.Wenn die Funktion jedoch an einem beliebigen Punkt aufgibt, werden die `Class.Instance` und ihre Nachkommen zu `nil` übernommen.

  Wenn die Eigenschaft `Class.Workspace.SignalBehavior` auf `Enum.SignalBehavior.Immediate` gesetzt ist, wird dieses Ereignis sofort ausgelöst, bevor die `Class.Instance` oder einer ihrer Vorfahren mit `Class.Instance:Destroy()` zerstört werden.

  Wenn die Eigenschaft `Class.Workspace.SignalBehavior` auf `Enum.SignalBehavior.Deferred` gesetzt ist, wird dieses Ereignis am nächsten Wiederaufnahmepunkt ausgelöst, der passieren wird, nachdem der `Class.Instance` oder einer seiner Vorfahren mit `Class.Instance:Destroy()` zerstört wurde.

  Mit dem `Enum.SignalBehavior.Deferred|Deferred`, ein Skript mit seinem eigenen `Class.Instance.Destroying` zu verbinden, ist problematisch, da das Skript vor dem Aufruf des Rückrufs zerstört wird (was bedeutet, dass es nicht ausgeführt wird).

  Wenn du ein `Class.Instance` in Studio löschst, z. B. manuell durch den [Explorer](/studio/explorer) oder durch ein Plugin, wird das `Class.Instance` nicht zerstört.Stattdessen wird der Elternteil auf `nil` festgelegt, die Sie mit `Class.Instance.AncestryChanged` verfolgen können.

Instance.Destroying

Feuert sofort vor (oder wird verschoben bis) die Instanz via `Class.Instance:Destroy()` zerstört wird.

Dieses Ereignis wird immer dann ausgelöst, wenn eine Style-Eigenschaft auf der Instanz geändert wird, einschließlich dann, wenn eine Eigenschaft auf `nil` gesetzt wird.

  ```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

Feuert immer dann, wenn eine Style-Eigenschaft auf der Instanz geändert wird, einschließlich dann, wenn eine Eigenschaft auf `nil` gesetzt wird.

Instance.childAdded

Diese Methode fügt einem Tag der Instanz einen Effekt hinzu, ohne dass es Auswirkungen hat, wenn der Tag bereits angewendet wird.Der erfolgreiche Hinzuschalten eines Tags schaltet ein Signal ab, das von `Class.CollectionService:GetInstanceAddedSignal()` mit dem angegebenen Tag erstellt wurde.

  ##### Warnungen

  *   Die Tags einer Instanz, die auf clientseitig hinzugefügt wurden, werden fallen gelassen, wenn der Server später ein Tag auf dieser Instanz hinzufügt oder entfernt, weil der Server alle Tags zusammen repliziert und vorherige Tags überschreibt.

  *   Wenn Sie eine Instanz kennzeichnen, ist es üblich, dass einige Ressourcen verwendet werden, um dem Tag seine Funktionalität zu geben, zum Beispiel Ereignisverbindungen oder Tabellen.Um Speicherlecks zu verhindern, ist es eine gute Idee, diese zu löschen (verbinden Sie sich ab, stellen Sie auf `nil` ein usw.), wenn sie für einen Tag nicht mehr benötigt werden.Tun Sie dies, wenn Sie `Class.Instance:RemoveTag()` aufrufen, `Class.Instance:Destroy()` aufrufen oder in einer Funktion, die mit einem von `Class.CollectionService:GetInstanceRemovedSignal()` zurückgegebenen Signal verbunden ist.

Instance:AddTag

Diese Funktion zerstört alle Kinder und Nachkommen einer Instanz.

  ```
  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
  ```

  Wenn du nicht alle **Kinder und Nachkommen** zerstören möchtest, verwende entweder `Class.Instance:GetChildren()` oder `Class.Instance:GetDescendants()`, um durch diese Kinder/Nachkommen zu schleifen und auszuwählen, was zu zerstören ist.Zum Beispiel wird das folgende Codebeispiel alle `Class.BasePart|BaseParts` absteigend von einem `Class.Model` zerstören:

  ```
  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

Diese Funktion zerstört alle Kinder einer Instanz.

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

`Clone()` erstellt eine Kopie einer Instanz und all ihrer Nachkommen, ignoriert alle Instanzen, die nicht `Class.Instance.Archivable|Archivable` sind.Die Kopie der Wurfinstanz wird mit dieser Methode zurückgegeben und ihre `Class.Instance.Parent|Parent` wird auf `nil` gesetzt.Beachten Sie, dass, wenn die Instanz selbst auf `Class.Instance.Archivable|Archivable` gesetzt ist auf `false`, diese Funktion `nil` zurückgibt.

  Wenn eine Referenz属性 wie `Class.ObjectValue.Value` in einer geklonten Instanz festgelegt wird, hängt der Wert der Kopieigenschaft vom Wert der ursprünglichen属性 ab:

  *   Wenn eine Referenz-Eigenschaft sich auf eine Instanz bezieht, die auch **geklont wurde** , wird die Kopie sich auf die Kopie beziehen.
  *   Wenn eine Referenz-Eigenschaft sich auf ein Objekt bezieht, das nicht **geklont wurde** , wird der gleiche Wert in der Kopie beibehalten.

Instance:Clone

Erstelle eine Kopie einer Instanz und all ihrer Nachkommen, unabhängig von Instanzen, die nicht `Class.Instance.Archivable|Archivable` sind.

Zeigt die Zerstörung eines Teils mit der `Class.Instance:Destroy()`-Funktion auf.

  Diese Funktion ist der korrekte Weg, um Objekte loszuwerden, die nicht mehr benötigt werden.

Setzt die Eigenschaft `Class.Instance.Parent` auf `nil`, sperrt die Eigenschaft `Class.Instance.Parent` und trennt alle Verbindungen und ruft `Destroy()` auf allen Kindern auf.Diese Funktion ist der korrekte Weg, um Objekte loszuwerden, die nicht mehr benötigt werden.

  Die Entfernung unbenötigter Objekte ist wichtig, da unnötige Objekte und Verbindungen an einem Ort Speicher verbrauchen, was mit der Zeit zu ernsthaften Leistungsproblemen führen kann.

  Als Best Practice, nachdem du `Destroy()` auf ein Objekt aufgerufen hast, lege alle Variablen, die sich auf das Objekt (oder seine Nachkommen) beziehen, auf `nil` fest.Dies verhindert, dass dein Code etwas mit dem Objekt zu tun hat.

  ```lua
  local part = Instance.new("Part")
  part.Name = "Hello, world"
  part:Destroy()
  -- Tun Sie das nicht:
  print(part.Name)  --> "Hallo, Welt"
  -- Tun Sie dies, um die obige Zeile von der Arbeit zu verhindern:
  part = nil
  ```

  Sobald ein `Class.Instance` durch diese Methode zerstört wurde, kann es nicht wiederverwendet werden, da die `Class.Instance.Parent` Eigenschaft gesperrt ist.Um **vorübergehend** ein Objekt zu entfernen, anstatt es zu zerstören, setze `Class.Instance.Parent|Parent` auf `nil`.Zum Beispiel:

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

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

  Um ein Objekt nach einer bestimmten Zeit zu zerstören, verwende `Class.Debris:AddItem()`.

Instance:Destroy

Setzt die Eigenschaft `Class.Instance.Parent` auf `nil`, sperrt die Eigenschaft `Class.Instance.Parent` und trennt alle Verbindungen und ruft `Destroy()` auf allen Kindern auf.

Gibt den ersten Vorfahren der `Class.Instance` zurück, dessen `Class.Instance.Name` dem angegebenen Namen gleich ist.

  Diese Funktion funktioniert nach oben, d.h. sie beginnt bei der unmittelbaren Instanz `Class.Instance.Parent` und arbeitet sich nach oben bis zur `Class.DataModel`.Wenn kein passender Vorfahre gefunden wird, gibt er `nil` zurück.

  Das folgende Code-Snippet würde den ersten Vorfahren des Objekts namens `Car` finden.

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

  Für Varianten dieser Funktion, die Vorfahren einer bestimmten Klasse finden, siehe `Class.Instance:FindFirstAncestorOfClass()` und `Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

Die `Class.Instance.Name` , die gesucht werden müssen.

Gibt den ersten Vorfahren der `Class.Instance` zurück, dessen `Class.Instance.Name` dem angegebenen Namen gleich ist.

Gibt den ersten Vorfahren der `Class.Instance` zurück, dessen `Class.Object.ClassName` dem angegebenen Klassen gleich ist.

  Diese Funktion funktioniert nach oben, d.h. sie beginnt bei der unmittelbaren Instanz `Class.Instance.Parent` und arbeitet sich nach oben bis zur `Class.DataModel`.Wenn kein passender Vorfahre gefunden wird, gibt er `nil` zurück.

  Eine häufige Verwendung dieser Funktion ist die Feststellung, dass `Class.Model` eine `Class.BasePart` gehört. Zum Beispiel:

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

  Diese Funktion ist eine Variante von `Class.Instance:FindFirstAncestor()`, die das Eigenschaft `Class.Object.ClassName` überprüft, anstatt `Class.Instance.Name`.`Class.Instance:FindFirstAncestorWhichIsA()` existiert auch, verwendet die Methode `Class.Object:IsA()` anstelle der Klassen-Erbschaft zu respektieren.

Instance:FindFirstAncestorOfClass

className

Die `Class.Object.ClassName` , die gesucht werden müssen.

Gibt den ersten Vorfahren der `Class.Instance` zurück, dessen `Class.Object.ClassName` dem angegebenen Klassen gleich ist.

Gibt den ersten Vorfahren der `Class.Instance` für zurück, für den `Class.Object:IsA()` wahr ist, für die angegebene Klasse.

  Diese Funktion funktioniert nach oben, d.h. sie beginnt bei der unmittelbaren Instanz `Class.Instance.Parent` und arbeitet sich nach oben bis zur `Class.DataModel`.Wenn kein passender Vorfahre gefunden wird, gibt er `nil` zurück.

  Im Gegensatz zu `Class.Instance:FindFirstAncestorOfClass()` verwendet diese Funktion `Class.Object:IsA()`, die die Klassen-Erbschaft respektiert. Zum Beispiel:

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

  Daher wird das folgende Codebeispiel den ersten `Class.BasePart` Vorfahren zurückgeben, unabhängig davon, ob es sich um einen `Class.WedgePart` , `Class.MeshPart` oder `Class.Part` handelt.

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

  Siehe auch `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Gibt den ersten Vorfahren der `Class.Instance` für zurück, für den `Class.Object:IsA()` wahr ist, für die angegebene Klasse.

Das Folgende würde im Arbeitsbereich nach einem Objektnamen "Brick" suchen. Wenn es gefunden wird, wird der Name des Objekts in "Foo" geändert.

Gibt das erste Kind der `Class.Instance` mit dem angegebenen Namen zurück oder `nil` wenn kein solches Kind existiert.Wenn das optionale `recursive` Argument `true` ist, sucht diese Funktion alle Nachkommen, anstatt nur die unmittelbaren Kinder des `Class.Instance` .

  ##### Überprüfen der Existenz eines Objekts

  `FindFirstChild()` ist erforderlich, wenn Sie überprüfen müssen, dass ein Objekt vor dem Fortfahren existiert.Wenn versucht wird, ein Kind mit dem Namen des Punktoпераators zu verzeichnen, wird ein Fehler ausgeworfen, wenn das Kind nicht existiert.

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

  -- Die folgenden Fehlerzeilen, wenn das Teil nicht im Arbeitsbereich existiert
  Workspace.Part.Transparency = 0.5
  ```

  Ein besserer Ansatz ist die Verwendung von `FindFirstChild()`, um zuerst nach `Part` zu suchen, dann eine `if`-Anweisung zu verwenden, um Code auszuführen, der es benötigt.

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

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

  ##### Ein Kind finden, dessen Name ein Eigenschaft entspricht

  Manchmal ist das `Class.Instance.Name|Name` eines Objekts dasselbe wie das einer Eigenschaft seiner `Class.Instance.Parent|Parent` .Wenn der Dot-Operator verwendet wird, haben Eigenschaften den Vorrang vor Kindern, wenn sie einen Namen teilen.

  Im folgenden Beispiel wird ein `Class.Folder` mit dem Namen `Color` zu einem `Class.Part` hinzugefügt, das auch die Eigenschaft `Class.Part.Color` besitzt.Beachten Sie, dass `part.Color` sich auf den `Datatype.Color3` Eigenschaftswert bezieht, nicht auf die Kind-`Class.Folder` Instanz.Ein Vorteil der Verwendung von `Class.Instance:FindFirstChild()|FindFirstChild()` ist, dass die Einführung neuer Eigenschaften kein Risiko für deinen Code darstellt.

  ```lua
  local part = Instance.new("Part")
  local folder = Instance.new("Folder")
  folder.Name = "Color"
  folder.Parent = part
  local c1 = part.Color  -- Die Eigenschaft
  local c2 = part:FindFirstChild("Color")  -- The child folder
  ```

  ##### Leistungsnotizen

  `Class.Instance:FindFirstChild()|FindFirstChild()` dauert etwa 20% länger als die Verwendung des Dot-Operators und fast 8-mal länger als die einfache Speicherung einer Referenz auf ein Objekt.Daher solltest du es vermeiden, es in Leistungsabhängigem Code wie in engen Schleifen oder Funktionen, die mit und verbunden sind, aufzurufen.Stattdessen speichere das Ergebnis in einer Variable oder betrachte die Verwendung von `Class.Instance.ChildAdded|ChildAdded` oder `Class.Instance:WaitForChild()|WaitForChild()`, um zu erkennen, wann ein Kind eines bestimmten Namens verfügbar wird.

Instance:FindFirstChild

Das `Class.Instance.Name` , das gesucht werden soll.

recursive

Ob die Suche recursiv durchgeführt werden soll oder nicht.

Gibt das erste Kind der `Class.Instance` mit dem angegebenen Namen zurück, die mit dem angegebenen Namen gefunden wurde.

Gibt das erste Kind der `Class.Instance`, deren `Class.Object.ClassName|ClassName` dem gegebenen `className` gleich ist.Im Gegensatz zu `Class.Instance:FindFirstChildWhichIsA()` gibt diese Funktion nur Objekte zurück, deren Klasse `className` entspricht, die Klassen-Erbschaft ignoriert.Wenn kein passendes Kind gefunden wird, gibt diese Funktion `nil` zurück.

Instance:FindFirstChildOfClass

Gibt das erste Kind der `Class.Instance`, deren `Class.Object.ClassName|ClassName` dem angegebenen Klassennamen gleich ist.

Gibt das erste Kind der `Class.Instance` für zurück, für die `Class.Object:IsA()` wahr ist, für die angegebene Klasse.

  Wenn kein passendes Kind gefunden wird, gibt diese Funktion `nil` zurück.Wenn das optionale rekursive Argument wahr ist, sucht diese Funktion alle Nachkommen, anstatt nur die unmittelbaren Kinder der `Class.Instance` .

  Im Gegensatz zu `Class.Instance:FindFirstChildOfClass()` verwendet diese Funktion `Class.Object:IsA()`, die die Klassen-Erbschaft respektiert. Zum Beispiel:

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

  Daher wird das folgende Codebeispiel das erste `Class.BasePart` -Kind zurückgeben, unabhängig davon, ob es ein `Class.WedgePart` , `Class.MeshPart` oder `Class.Part` ist.

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

  Entwickler, die ein Kind nach Namen suchen, sollten stattdessen `Class.Instance:FindFirstChild()` verwenden.

Instance:FindFirstChildWhichIsA

Das `Class.Object.ClassName` , das gesucht werden soll.

Gibt das erste Kind der `Class.Instance` für zurück, für die `Class.Object:IsA()` wahr ist, für die angegebene Klasse.

Gibt den ersten Nachkommen zurück, der mit dem angegebenen `Class.Instance.Name` gefunden wurde.

  Diese Methode ist deaktiviert und nicht verwendbar.Um den ersten Nachkommen einer Instanz zu finden, gilt es, stattdessen den `recursive` -Parameter auf `Class.Instance:FindFirstChild()` zu verwenden.

Instance:FindFirstDescendant

Gibt den ersten Nachkommen zurück, der mit dem angegebenen `Class.Instance.Name` gefunden wurde.

Wenn das `Class.Instance` ein `Class.Actor` ist, wird das `Class.Actor` selbst zurückgegeben.Ansonsten wird sein nächster Vorfahre `Class.Actor` zurückgegeben.Wenn kein Vorfahre ein `Class.Actor` ist, ist das Ergebnis `nil` .

Instance:GetActor

Gibt die `Class.Actor` zurück, die mit der Instanz verbunden sind, wenn es welche gibt.

Diese Methode gibt den Wert zurück, der dem angegebenen Attributnamen zugewiesen wurde. Wenn kein Attribut zugewiesen wurde, wird `nil` zurückgegeben.

  Zum Beispiel legt das folgende Code-Snippet fest und holt dann den Wert des Attributes der Instanz `InitialPosition`:

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

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

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

  ##### Siehe auch

  *   `Class.Instance:SetAttribute()`, der das attribut mit dem angegebenen namen auf den angegebenen wert festlegt.
  *   `Class.Instance:GetAttributes()` , die ein wörterbuch von schlüssel-wertpaaren für jedes attribut der instanz zurückgibt.

Instance:GetAttribute

Der Name des Attributs, das abgerufen wird.

Der Wert, der dem angegebenen Attributnamen zugewiesen wurde. Wenn kein Attribut zugewiesen wurde, wird `nil` zurückgegeben.

Gibt den Wert zurück, der dem angegebenen Attributnamen zugewiesen wurde.

Diese Funktion gibt ein Ereignis zurück, das sich genau wie das Ereignis `Class.Object.Changed|Changed` verhält, außer dass es nur dann feuert, wenn sich ein bestimmtes angegebenes Attribut ändert; effektiv ist es ähnlich wie `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` für Attribute.

  Es ist im Allgemeinen eine gute Idee, diese Methode anstelle einer Verbindung zu `Class.Object.Changed|Changed` mit einer Funktion zu verwenden, die den Attributnamen überprüft.Subsequente Aufrufe dieser Methode auf demselben Objekt mit demselben Attributnamen geben das gleiche Ereignis zurück.

  Das folgende Codebeispiel gibt ein Signal zurück, das die Funktion `attributeChanged()` auslöst, wenn sich der Attributswert der Teile `InitialPosition` ändert:

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

  Siehe auch `Class.Instance.AttributeChanged`, das immer dann feuert, wenn ein Attribut auf der Instanz geändert wird.

Instance:GetAttributeChangedSignal

Der Name des angegebenen Attributes, für das das Änderungssignal zurückgegeben wird.

Ein Ereignis, das abgefeuert wird, wenn sich das angegebene Attribut ändert.

Gibt ein Ereignis zurück, das abgefeuert wird, wenn das angegebene Attribut geändert wird.

Diese Methode gibt ein Wörterbuch von Schlüssel-Wertpaaren für jedes Attribut zurück, bei dem der Schlüssel der Name des Attributes und der Wert ein nicht `nil` Wert ist.

  Zum Beispiel gibt das folgende Code-Snippet Ausgaben mit Attributen und Werten einer Instanz aus:

  ```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
  ```

  Siehe auch `Class.Instance:GetAttribute()`, die den Wert zurückgibt, der dem angegebenen Attributnamen zugewiesen wurde.

Instance:GetAttributes

Ein Wörterbuch von String → Variantenpaaren für jedes Attribut, bei dem der String der Name des Attributes ist und die Variante ein nicht-Null-Wert ist.

Gibt ein Wörterbuch der Attribute der Instanz zurück.

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

Gibt ein Array (eine nummerisch indexierte Tabelle) zurück, das alle direkten Kinder der Instanz enthält oder jedes `Class.Instance`, dessen `Class.Instance.Parent|Parent` dem Objekt gleich ist.Die Liste kann mit einer numerischen oder generischen for-Schleife iteriert werden:

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

  -- Zahlenspielschleifen-Beispiel
  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")

  -- Generisches for-Schleifen-Beispiel
  local children = Workspace:GetChildren()
  for i, child in children do
  	print(child.Name .. " is child number " .. i)
  end
  ```

  Die Kinder werden nach der Reihenfolge sortiert, in der ihr `Class.Instance.Parent|Parent` Eigenschaft auf das Objekt festgelegt wurde.

  Siehe auch die `Class.Instance:GetDescendants()|GetDescendants` Funktion.

Instance:GetChildren

Gibt ein Array zurück, das alle Kinder der Instanz enthält.

Gibt eine kodierte Zeichenkette der Fehler-ID zurück, die von Roblox intern verwendet wird. Beachten Sie:

  *   Dieser Gegenstand ist geschützt. Wenn du ihn in einem `Class.Script` oder `Class.LocalScript` verwenden möchtest, tritt ein Fehler auf.
  *   Eine Debug-ID ist eine ID, die in Debugging-Prozessen verwendet wird.Es ermöglicht einem Debugger, jede Anweisung vor dem Ausführen durch eine Anwendung zu lesen.Alle Objekte in Roblox agieren wie Prozesse und jede Ausführungsanweisung (oder "Code"), die bei Bedarf debugged werden kann.
  *   Dies kann für Plugins hilfreich sein, die ähnliche Objekte voneinander unterscheiden müssen (z. B. Objekte, die denselben Namen teilen).

Instance:GetDebugId

scopeLength

Gibt eine kodierte Zeichenkette der Fehler-ID zurück, die von Roblox intern verwendet wird.

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.

Diese Objekt-Methode gibt eine Liste zurück, die alle Nachkommen dieses Objekts enthält.Im Gegensatz zu `Class.Instance:GetChildren()`, die nur die unmittelbaren Kinder eines Objekts zurückgibt, findet diese Methode jedes Kind des Objekts, jedes Kind dieser Kinder und so weiter.

Instance:GetDescendants

Ein Array mit den Nachkommen der Instanz.

Gibt ein Array zurück, das alle Nachkommen der Instanz enthält.

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.

Gibt eine Zeichenkette zurück, die die Vorfahren der Instanz beschreibt.Die Zeichenkette ist eine Konkatenation des `Class.Instance.Name|Name` des Objekts und seiner Vorfahren, getrennt durch Zeichenstriche.Die `Class.DataModel` ( `game` ) wird nicht berücksichtigt.Zum Beispiel kann ein `Class.Part` in der `Class.Workspace` möglicherweise `Class.Workspace.Part` zurückgeben.

  Wenn auf einem `Class.Instance` aufgerufen wird, das kein Nachkomme des `Class.DataModel` ist, betrachtet diese Funktion alle Vorfahren bis zum obersten ohne `Class.Instance.Parent|Parent`.

  Diese Funktion ist nützlich für Loggen und Debuggen.Du solltest nicht versuchen, die zurückgegebene Zeichenkette für eine nützliche Operation zu analysieren; diese Funktion entkommt nicht den Perioden (oder anderen Symbolen) in Objektnamen.Mit anderen Worten, obwohl seine Ausgabe oft wie ein gültiger Luau-Identifikator aussieht, ist sie nicht garantiert.

Instance:GetFullName

Gibt eine Zeichenkette zurück, die die Vorfahren der Instanz beschreibt.

Diese Methode gibt den gestilten oder explizit modifizierten Wert der angegebenen Eigenschaft zurück, oder sonst den Standard-Eigenschaftswert, wenn er nicht gestylt/modifiziert wurde.Dies unterscheidet sich leicht vom Zugriff auf den Eigenschaftswert direkt, wie `[GuiObject].Rotation`, der den Standard- oder modifizierten Wert der Eigenschaft zurückgibt.

  ```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"

  -- Verweis auf eine Schaltfläche
  local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

  print(button:GetStyled("Rotation")) --> 0 (standardwert)
  print(button.Rotation) --> 0 (standardwert)

  -- Drehung durch Style-Regel-Eigenschaft anwenden
  rule:SetProperty("Rotation", 30)

  print(button:GetStyled("Rotation")) --> 30 (stylisher wert basierend auf regel)
  print(button.Rotation) --> 0 (standardwert)

  -- Stilgebundene Eigenschaft explizit modifizieren/überschreiben
  button.Rotation = 45

  print(button:GetStyled("Rotation")) --> 45 (modifizierter wert)
  print(button.Rotation) --> 45 (modified value)
  ```

Instance:GetStyled

Der gestylte oder explizit modifizierte Wert der angegebenen Eigenschaft oder alternativ der Standard-Eigenschaftswert, wenn er nicht gestylt/modifiziert wurde.

Gibt den gestilten oder explizit modifizierten Wert der angegebenen Eigenschaft zurück, oder sonst den Standard-Eigenschaftswert, wenn er nicht gestylt/modifiziert wurde.

Diese Methode gibt ein Ereignis zurück, das sich genau wie das Ereignis `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` verhält, außer dass es nur dann feuert, wenn die angegebene Stileigenschaft geändert wird.Es ist im Allgemeinen eine gute Idee, diese Methode anstelle einer Verbindung zu `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` mit einer Funktion zu verwenden, die den Namen der Eigenschaft überprüft.Subsequente Aufrufe dieser Methode auf demselben Objekt mit demselben Eigenschaftsnamen geben das gleiche Ereignis zurück.

  Beachten Sie, dass dieses Ereignis keine Argumente an eine verbundene Funktion übergeben wird, so muss der Wert der geänderten Eigenschaft direkt innerhalb eines Skripts gelesen werden.

  ```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

Name der Stil属ität, für die Änderungen zu hören sind.

Ereignis, das abgefeuert wird, wenn sich die angegebene Stil-Eigenschaft ändert.

Diese Methode gibt eine Reihe der auf die angegebene Instanz angewendeten Tags als Zeichen zurück.Du kannst Tags entweder im Studio-Fenster [Eigenschaften](/studio/properties) hinzufügen oder zur Laufzeit mit `Class.Instance:AddTag()|AddTag()` .

  Diese Methode ist nützlich, wenn du etwas mit mehreren Tags auf einer Instanz auf einmal tun möchtest.Es ist jedoch ineffizient, diese Methode zu verwenden, um nach der Existenz eines einzelnen Tags zu suchen; stattdessen verwende `Class.Instance:HasTag()|HasTag()`, um nach einem bestimmten Tag zu suchen.

Instance:GetTags

Erhalte eine Liste aller Tags, die auf die Instanz angewendet werden.

Diese Methode gibt `true` zurück, wenn der angegebene Tag dem Objekt hinzugefügt wurde.Du kannst Tags entweder im Studio-Fenster [Eigenschaften](/studio/properties) hinzufügen oder zur Laufzeit mit `Class.Instance:AddTag()|AddTag()` .

Instance:HasTag

Überprüfe, ob die Instanz ein bestimmtes Tag hat.

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.

Gibt wahr zurück, wenn ein `Class.Instance` ein Vorfahrt des angegebenen Nachkommens ist.

  Ein `Class.Instance` wird als Vorfahre eines Objekts betrachtet, wenn das Objekt seine `Class.Instance.Parent` oder eines seiner Eltern `Class.Instance.Parent` auf die `Class.Instance` festlegt.

  Siehe auch, `Class.Instance:IsDescendantOf()` .

Instance:IsAncestorOf

Wahr, wenn das `Class.Instance` ein Vorfahre des angegebenen Nachkommens ist.

Gibt wahr zurück, wenn ein `Class.Instance` ein Vorfahrt des angegebenen Nachkommens ist.

Gibt `true` zurück, wenn ein `Class.Instance` ein Nachkomme des angegebenen Vorfahren ist.

  Beachten Sie, dass `IsDescendantOf()` nicht mit einem Parameter von `nil` verwendet werden kann, um zu überprüfen, ob ein Objekt entfernt wurde.

  Siehe auch `Class.Instance:IsAncestorOf()`.

Instance:IsDescendantOf

ancestor

Wahr, wenn das `Class.Instance` ein Nachkomme des angegebenen Vorfahren ist.

Gibt `true` zurück, wenn ein `Class.Instance` ein Nachkomme des angegebenen Vorfahren ist.

Gibt `true` zurück, wenn der in der angegebenen Eigenschaft gespeicherte Wert dem Code-instanzierten Standard gleich ist.Wenn zum Beispiel die Ausgabe der Eigenschaft von einem den Wert anzeigt, wird die Aufrufung von auf dem Etikett die Rückgabe von erzielen, weil der Standardwert für ist, wenn das Etikett über die Studio-Eingabe-Workflows erstellt wird, anstatt durch die Einfügung durch die Studio-Eingabe-Workflows eingefügt zu werden.

  Beachten Sie, dass, wenn diese Methode `true` zurückgibt, das Styling **nicht** die Eigenschaft beeinflussen wird, da die explizite Änderung einer Eigenschaft dem Styling vorzuziehen ist.

Instance:IsPropertyModified

Boolean, der anzeigt, ob die Eigenschaft modifiziert wurde.

Gibt `true` zurück, wenn der in der angegebenen Eigenschaft gespeicherte Wert dem Code-instanzierten Standard gleich ist.

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

Diese Funktion legt die `Class.Instance.Parent` des Objekts auf `nil` fest und macht dasselbe für alle seine Nachkommen.

  Wenn das Objekt vor der Entfernung referenziert wird, ist es möglich, das Objekt zu einem späteren Zeitpunkt abzurufen.

Instance:Remove

Setzt das Objekt `Parent` auf `nil` und macht dasselbe für alle seine Nachkommen.

Diese Methode entfernt ein Tag von einer Instanz.Es wird keine Fehler werfen, wenn das Objekt kein Tag hat.Die erfolgreiche Entfernung eines Tags schaltet ein Signal ab, das von `Class.CollectionService:GetInstanceRemovedSignal()` mit dem angegebenen Tag erstellt wurde.

  Beachten Sie, dass es üblich ist, dass einige Ressourcen verwendet werden, um dem Tag seine Funktionalität zu geben, zum Beispiel Verbindungen zu Ereignissen oder Tabellen.Um Speicherlecks zu verhindern, ist es eine gute Idee, diese zu löschen (verbinden Sie sich ab, stellen Sie auf `nil` ein usw.), wenn sie für einen Tag nicht mehr benötigt werden.

Instance:RemoveTag

Setzt ein Eigenschaft auf ihren Standardwert zurück.Zum Beispiel ist das Aufrufen von `ResetPropertyToDefault("Rotation")` auf einem `Class.TextLabel` gleichbedeutend mit dem Festlegen seiner `Class.TextLabel.Rotation|Rotation` auf `0` (der Standardwert der Eigenschaft).Diese Methode kann verwendet werden, um sicherzustellen, dass das Styling den Standardwert dieser Eigenschaft überschreibt.

Instance:ResetPropertyToDefault

Name der zu zurücksetzenden Eigenschaft.

Setzt ein Eigenschaft auf ihren Standardwert zurück.

Diese Methode legt das Attribut mit dem angegebenen Namen auf den angegebenen Wert fest.Wenn der angegebene Wert `nil` ist, wird das Attribut entfernt, da `nil` standardmäßig zurückgegeben wird.

  Zum Beispiel legt das folgende Code-Snippet das Attribut der Instanz `InitialPosition` auf `Datatype.Vector3|Vector3.new(0, 10, 0)` fest:

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

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

  ##### Beschränkungen

  Namensanforderungen und Einschränkungen:

  *   Namen dürfen nur alphanumerische Zeichen und Unterstrich verwenden.
  *   Keine Leerstellen oder einzigartigen Symbole sind erlaubt.
  *   Schnüre müssen 100 Zeichen oder weniger sein.
  *   Namen dürfen nicht mit **RBX** beginnen, es sei denn, der Anrufer ist ein Roblox-Kernskript (reserviert für Roblox).

  Wenn versucht wird, ein Attribut auf einen nicht unterstützten Typ zu setzen, wird ein Fehler geworfen.

  ##### Siehe auch

  *   `Class.Instance:GetAttribute()`, die den wert zurückgibt, der dem angegebenen attributnamen zugewiesen wurde.
  *   `Class.Instance:GetAttributes()` , die ein wörterbuch von schlüssel-wertpaaren für jedes attribut der instanz zurückgibt.

Instance:SetAttribute

Der Name des Attributs, das festgelegt wird.

value

Der Wert, mit dem das angegebene Attribut festgelegt wird.

Setzt das Attribut mit dem angegebenen Namen auf den angegebenen Wert.

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

Gibt das Kind der `Class.Instance` mit dem angegebenen Namen zurück.Wenn das Kind nicht existiert, wird es den aktuellen Thread ergeben, bis es es tut.Wenn der `timeOut` -Parameter angegeben wird, läuft diese Methode nach der angegebenen Anzahl von Sekunden ab und gibt `nil` zurück.

  ##### Primäre Verwendung

  `Class.Instance:WaitForChild()|WaitForChild()` ist extrem wichtig, wenn Sie an Code arbeiten, der vom Client in einem `Class.LocalScript` ausgeführt wird.Die Roblox-Engine garantiert nicht die Reihenfolge oder die Zeit, in der Objekte vom Server zum Client repliziert werden.Zusätzlich, wenn ein Erlebnis auf Wahr gesetzt ist `Class.Workspace.StreamingEnabled`, können `Class.BasePart|BaseParts` nicht zum Client gestreamt werden, die weit weg vom Charakter des Spielers sind, was dazu führen kann, dass Skripte beim Indexieren von Objekten, die auf dem Client noch nicht existieren, beschädigt werden.

  ##### Anmerkungen

  *   Diese Funktion gibt nicht aus, wenn ein Kind mit dem angegebenen Namen existiert, wenn die Anruf getätigt wird.
  *   `Class.Instance:FindFirstChild()` ist eine effizientere alternative zu `Class.Instance:WaitForChild()|WaitForChild()` für objekte, die vermutet werden.
  *   Wenn ein Anruf bei dieser Methode mehr als 5 Sekunden überschreitet, ohne zurückzukehren, und kein `timeOut`-Parameter angegeben wurde, wird eine Warnung gedruckt, dass der Thread ununterbrochen ausgegeben werden kann.

Instance:WaitForChild

childName

timeOut

Gibt das Kind des `Class.Instance` mit dem angegebenen Namen zurück. Wenn das Kind nicht existiert, wird es den aktuellen Thread ergeben, bis es dies tut.

Die Kinderfunktion gibt eine Liste der Kinder des Objekts zurück.

Instance:children

Gibt eine Liste der Kinder des Objekts zurück.

Instance:clone

Instance:destroy

Instance:findFirstChild

Instance:getChildren

Instance:isDescendantOf

Instance:remove

Instance

Diese Eigenschaft bestimmt, ob die Instanz enthalten sein soll, wenn die Erfahrung veröffentlicht oder gespeichert wird, oder wenn `Class.Instance:Clone()|Clone()` auf einem der Vorfahren der Instanz aufgerufen wird.Das Direktaufrufen von auf einer Instanz wird zurückgeben, wenn diese Instanz nicht ist .

  Das Kopieren eines Objekts in Studio mit den Optionen **Duplizieren** oder **Kopieren** / **Einfügen** ignoriert seine eigene `Class.Instance.Archivable|Archivable` Eigenschaft und setzt `Class.Instance.Archivable|Archivable` auf `true` für die Kopie.

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

Instance.Archivable

Bestimmt, ob ein `Class.Instance` und seine Nachkommen mit `Class.Instance:Clone()` geklont werden können und gespeichert/veröffentlicht werden können.

Die Gruppe der Fähigkeiten, die für Skripte innerhalb dieser Instanz verwendet werden können.Für die Inkraftsetzung der Fähigkeiten muss die `Class.Instance.Sandboxed` Eigenschaft aktiviert sein.

  Diese Eigenschaft wird von einer experimentellen Funktion verwendet. Siehe [Skript-Fähigkeiten](/scripting/capabilities) für weitere Details.

Instance.Capabilities

Die Gruppe der Fähigkeiten, die für Skripte innerhalb dieses Containers verwendet werden kann.

Eine nicht eindeutige Kennung des `Class.Instance`.Namen werden verwendet, um die Objektarchitektur zu organisieren und Skripten den Zugriff auf spezifische Objekte zu ermöglichen.Der Name einer Instanz darf nicht mehr als 100 Zeichen groß sein.

  Der Name eines Objekts wird oft verwendet, um auf das Objekt über die Datenmodell-Hierarchie mit den folgenden Methoden zuzugreifen:

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

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

  Um ein Objekt mit dem Punktoperator ( `.` ) zugänglich zu machen, muss sein Name mit einem Unterstrich oder einem Buchstaben beginnen, und der Rest des Namens kann nur Buchstaben, Zahlen oder Unterstriche enthalten (keine anderen Sonderzeichen).Wenn der Name eines Objekts dieser Syntax nicht folgt, ist es nicht über den Punkt-Operator zugänglich und Luau interpretiert seinen Namen nicht als Identifikator.

  Wenn mehr als ein Objekt mit demselben Namen Geschwister sind, wird jede Versuche, ein Objekt nach diesem Namen zu indexieren, nur eines der Objekte zurückgeben, ähnlich wie `Class.Instance:FindFirstChild()`, aber nicht immer das gewünschte Objekt.Wenn ein bestimmtes Objekt über Code zugänglich sein muss, wird empfohlen, es einen einzigartigen Namen zu geben oder zu garantieren, dass keiner seiner Geschwister denselben Namen teilt.

  Siehe auch `Class.Instance:GetFullName()`, um einen vollständigen Namen zu erhalten, einschließlich der Hierarchie des Objekts.

Instance.Name

Eine nicht eindeutige Kennung des `Class.Instance`.

Die Eigenschaft `Parent` bestimmt den hierarchischen Eltern des `Class.Instance`.Die folgende Terminologie wird häufig verwendet, wenn es darum geht, wie diese Eigenschaft festgelegt wird:

  *   Ein Objekt ist ein **Kind** von, oder wird **übernommen** , ein anderes Objekt, wenn sein `Parent` auf dieses Objekt festgelegt ist.

  *   Die **Nachkommen** eines `Class.Instance` sind die Kinder dieses Objekts, plus die Nachkommen der Kinder ebenfalls.

  *   Die **Vorfahren** eines `Class.Instance` sind alle Objekte, von denen die Instanz ein Nachkomme ist.

  Es ist von der `Parent` Eigenschaft, dass viele andere API-Mitglieder ihren Namen erhalten, wie `Class.Instance:GetChildren()|GetChildren()` und `Class.Instance:FindFirstChild()|FindFirstChild()`.Diese Eigenschaft wird auch verwendet, um zu verwalten, ob ein Objekt in der Erfahrung existiert oder entfernt werden muss.Solange der Eltern eines Objekts in der `Class.DataModel` , in einer Variable gespeichert wird oder durch das Eigenschaft eines anderen Objekts referenziert wird, bleibt das Objekt in der Erfahrung; ansonsten wird das Objekt automatisch entfernt.

  Das Aufrufen von `Class.Instance:Destroy()|Destroy()` wird die `Parent` eines `Class.Instance` und all seiner Nachkommen auf `nil` festlegen, und auch **sperren** die `Parent` Eigenschaft.Bei der Festlegung des `Parent` eines zerstörten Objekts wird ein Fehler erhoben.

  Neu erstellte Objekte mit `Datatype.Instance.new()` werden keinen Eltern haben und sind normalerweise nicht sichtbar oder funktionsfähig, bis ein Eltern festgelegt wird.

  ##### Objekt-Replikation

  Ein von dem Server erstelltes Objekt wird sich nicht auf Clients replizieren, bis es einem Objekt zugewiesen wird, das repliziert wird.Wenn du ein Objekt erstellst und viele Eigenschaften festlegst, wird empfohlen, die Eigenschaft `Parent` zu setzen **last** .Dies gewährleistet, dass das Objekt einmal repliziert wird, anstatt viele Eigenschaftsänderungen zu replizieren.

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

  -- Setze den Eltern der neuen Instanz zuletzt (empfohlen)
  local part = Instance.new("Part")
  part.Position = Vector3.new(0, 10, 0)
  part.Parent = Workspace
  ```

  Wenn jedoch Elternteile an einen `Class.Model` übertragen werden, dessen Elternteil noch nicht festgelegt wurde, ist die Übertragung jedes Teils an dieses Modell akzeptabel, da das Modell nicht repliziert worden wäre.

Instance.Parent

Bestimmt den hierarchischen Eltern des `Class.Instance`.

Diese Eigenschaft wurde verwendet, um Objekte im `Class.CoreGui` vor Änderungen durch Benutzer in unautorisierter Weise zu schützen.Es wurde veraltet und tut nichts.

Instance.RobloxLocked

Eine veraltete Eigenschaft, die dazu gedient hat, `Class.CoreGui` Objekte zu schützen.

Verwandelt die Instanz in einen **verschachtelten Container** , eine experimentelle Funktion, die die Aktionen einschränkt, die Skripte innerhalb eines bestimmten Containers ausführen können.Siehe [Skript-Fähigkeiten](/scripting/capabilities) für weitere Details.

Instance.Sandboxed

Verwandelt die Instanz in einen sandboxierten Container.

`Instance` ist die Basisklasse für alle Klassen in der Roblox-Klassenpyramide, die Teil des `Class.DataModel` Baums sein können.

/reference/engine/classes/SpawnerService.yaml