---
title: "Astra.Components.ComponentQueries"
version: snapshot-2026-10-07
engineGeneration: astra-current
language: C#
status: semantic-reference
reviewedAt: 2026-10-07
appRelease: "0.2.3-preview.20261007"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/api/astra-components-componentqueries/
---

# Astra.Components.ComponentQueries

Queries over real native component instances; ordinal order is preserved. Unity 6000.0 GetComponentsInChildren/GetComponentsInParent are the reference contracts.

**Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Class

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
class Astra.Components.ComponentQueries
```

Queries over real native component instances; ordinal order is preserved. Unity 6000.0 GetComponentsInChildren/GetComponentsInParent are the reference contracts.

## Onde acessar este tipo

Crie/compile um Behavior na área de código e anexe ao objeto. **Object**, **Scene** e **Scenes** dão acesso ao mundo da sessão. Referências autorais são resolvidas com Resolve; handles do Play anterior não são reutilizados.

## Roadmap e uso

[Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [GetComponents](#member-5249e5a09a3b452b) | Method |
| [GetComponents](#member-275806c5c87462a4) | Method |
| [GetComponentsInChildren](#member-e47464d52b4e5625) | Method |
| [GetComponentsInChildren](#member-45108e918bb3bf7a) | Method |
| [GetComponentsInParent](#member-dfa9096a1caf64f4) | Method |
| [TryGetComponent](#member-ebaee0f791e4a617) | Method |

<h3 id="member-5249e5a09a3b452b" class="astra-member">GetComponents</h3>

```csharp
public static void GetComponents<T>(Astra.GameObject owner, System.Collections.Generic.List<T> results) where T : struct, Astra.Components.IComponentFacade<T>
```

Writes into caller-owned storage without allocating a result array.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Writes into caller-owned storage without allocating a result array.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |
| `results` | `System.Collections.Generic.List&lt;T&gt;` |  |

<h3 id="member-275806c5c87462a4" class="astra-member">GetComponents</h3>

```csharp
public static T[] GetComponents<T>(Astra.GameObject owner) where T : struct, Astra.Components.IComponentFacade<T>
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |

<h3 id="member-e47464d52b4e5625" class="astra-member">GetComponentsInChildren</h3>

```csharp
public static void GetComponentsInChildren<T>(Astra.GameObject owner, bool includeInactive, System.Collections.Generic.List<T> results) where T : struct, Astra.Components.IComponentFacade<T>
```

Depth-first, self first, child order preserved. Self is searched even when inactive; inactive descendants are excluded by default. Disabled components remain discoverable.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Depth-first, self first, child order preserved. Self is searched even when inactive; inactive descendants are excluded by default. Disabled components remain discoverable.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |
| `includeInactive` | `bool` |  |
| `results` | `System.Collections.Generic.List&lt;T&gt;` |  |

<h3 id="member-45108e918bb3bf7a" class="astra-member">GetComponentsInChildren</h3>

```csharp
public static T[] GetComponentsInChildren<T>(Astra.GameObject owner, bool includeInactive = false) where T : struct, Astra.Components.IComponentFacade<T>
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |
| `includeInactive` | `bool` |  · Opcional: `False` |

<h3 id="member-dfa9096a1caf64f4" class="astra-member">GetComponentsInParent</h3>

```csharp
public static T[] GetComponentsInParent<T>(Astra.GameObject owner, bool includeInactive = false) where T : struct, Astra.Components.IComponentFacade<T>
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |
| `includeInactive` | `bool` |  · Opcional: `False` |

<h3 id="member-ebaee0f791e4a617" class="astra-member">TryGetComponent</h3>

```csharp
public static bool TryGetComponent<T>(Astra.GameObject owner, out T component) where T : struct, Astra.Components.IComponentFacade<T>
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Objetos, Behaviors e composição](/pt-br/snapshot-2026-10-06/roadmap/objetos-e-scripts/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `owner` | `Astra.GameObject` |  |
| `component` | `T` |  · Out |