---
title: GetComponentData
summary: Lesen Sie die Komponentendaten in Lua UI, indem Sie den Objektnamen als Beispiel verwenden.
section: reference
kind: api
status: reference
updated: 2026-10-22
tags: ["X4","modding","get","component","data"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/"]
---
## Rückgabewert

| Typ | Bedeutung |
| --- | --- |
| [`any`](wiki:type-results), ... | Ein Ergebnis pro angefordertem Feld. Das Namefeld in diesem Beispiel ist string; andere Felder haben eigene Verträge. |

[Typen und Methoden](wiki:types)

## Vordruck


Ebene: Spiel Lua UI. `component` ist eine Skriptkomponente-ID in der von dieser Funktion erwarteten Darstellung; `name` Wählen Sie das Feld. Lösen Sie das Objekt zuerst im aktuellen Prozess. Die Funktion erzeugt nicht automatisch die Komponente-Variable.




```lua
local name = GetComponentData(component, "name")
```



**Was geschieht:** Für eine gültige Komponentenreferenz erhält der Name seinen Namen; ein Objekt namens Scout liefert den String „Scout". Der Wert wird nicht automatisch protokolliert.

## Projektbeobachtung


Nach dem renaming, lesen Sie den Namen des realen Objekts und vergleichen Sie es mit dem erwarteten Ergebnis. Aktualisieren Ihres eigenen Fenstertext ist kein Beweis, dass das Spielobjekt geändert.



## Fehlertyp


Geben Sie FFI cdata nicht nur, weil es sich auf ein Objekt bezieht. Navigationsforschung fand verschiedene Konvertierungspfade für Benutzeroberflächenhandles, numerische IDs und UniverseID. Feldunterstützung und Rückgabetypen hängen von der Abfrage ab; dieser Artikel dokumentiert den Namen readback anstatt jeden unterstützten Schlüssel. Siehe [ID-Präzision](wiki:ids-and-precision).