---
title: "Astra.SaveStore"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-savestore/
---

# Astra.SaveStore

One project-owned save namespace. Changes to keys commit with Flush; standalone files commit immediately. Errors never select a temporary directory.

**Namespace:** `Astra` · **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.SaveStore
```

One project-owned save namespace. Changes to keys commit with Flush; standalone files commit immediately. Errors never select a temporary directory.

**Interfaces:** `System.IDisposable`.

## Onde acessar este tipo

No Behavior, **Save** dá acesso ao armazenamento do projeto. Use chave e versão explícitas; salvar estado de gameplay não é salvar cena autoral.

## 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 |
|---|---|
| [MaxFileBytes](#member-e8a33f263513c6b7) | Field |
| [MaxFilesBytes](#member-59b0c0e052382883) | Field |
| [MaxSnapshotBytes](#member-7234e33d5f2e8cd6) | Field |
| [.ctor](#member-3a2f1a08a2f9b320) | Method |
| [Contains](#member-3310b6e5d62d9d9e) | Method |
| [Delete](#member-a1c0b61e31064148) | Method |
| [DeleteFile](#member-2dff6e79faeffc36) | Method |
| [Dispose](#member-fe863bc26f0ac749) | Method |
| [Flush](#member-5e19e1277286e441) | Method |
| [GetBoolean](#member-325653a0a1bdb7b9) | Method |
| [GetDouble](#member-4ecb6f7df880d0e7) | Method |
| [GetInt64](#member-8a4f75766e8c066f) | Method |
| [GetString](#member-8404b54db388fae8) | Method |
| [ReadBytes](#member-a5a19cd540eb0300) | Method |
| [ReadText](#member-f1171b154ec5c59e) | Method |
| [SetBoolean](#member-d4982c73cc22deba) | Method |
| [SetDouble](#member-6e877bd43fb1abfd) | Method |
| [SetInt64](#member-3124820be3628cdd) | Method |
| [SetString](#member-cceabf5879d036be) | Method |
| [WriteBytes](#member-908a261067b19f9c) | Method |
| [WriteText](#member-d6d142b9d8f81142) | Method |
| [Recovery](#member-f98340893693e622) | Property |

<h3 id="member-e8a33f263513c6b7" class="astra-member">MaxFileBytes</h3>

```csharp
public const int MaxFileBytes = 1048576
```

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

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**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.

<h3 id="member-59b0c0e052382883" class="astra-member">MaxFilesBytes</h3>

```csharp
public const long MaxFilesBytes = 16777216
```

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

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**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.

<h3 id="member-7234e33d5f2e8cd6" class="astra-member">MaxSnapshotBytes</h3>

```csharp
public const int MaxSnapshotBytes = 262144
```

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

**Uso:** Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

**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.

<h3 id="member-3a2f1a08a2f9b320" class="astra-member">.ctor</h3>

```csharp
public SaveStore(string projectRoot)
```

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

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**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 |
|---|---|---|
| `projectRoot` | `string` |  |

<h3 id="member-3310b6e5d62d9d9e" class="astra-member">Contains</h3>

```csharp
public bool Contains(string key)
```

**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 |
|---|---|---|
| `key` | `string` |  |

<h3 id="member-a1c0b61e31064148" class="astra-member">Delete</h3>

```csharp
public bool Delete(string key)
```

**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 |
|---|---|---|
| `key` | `string` |  |

<h3 id="member-2dff6e79faeffc36" class="astra-member">DeleteFile</h3>

```csharp
public bool DeleteFile(string safeRelativePath)
```

**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 |
|---|---|---|
| `safeRelativePath` | `string` |  |

<h3 id="member-fe863bc26f0ac749" class="astra-member">Dispose</h3>

```csharp
public void Dispose()
```

**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.

<h3 id="member-5e19e1277286e441" class="astra-member">Flush</h3>

```csharp
public void Flush()
```

**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.

<h3 id="member-325653a0a1bdb7b9" class="astra-member">GetBoolean</h3>

```csharp
public bool GetBoolean(string key, bool fallback = false)
```

**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 |
|---|---|---|
| `key` | `string` |  |
| `fallback` | `bool` |  · Opcional: `False` |

<h3 id="member-4ecb6f7df880d0e7" class="astra-member">GetDouble</h3>

```csharp
public double GetDouble(string key, double fallback = 0)
```

**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 |
|---|---|---|
| `key` | `string` |  |
| `fallback` | `double` |  · Opcional: `0` |

<h3 id="member-8a4f75766e8c066f" class="astra-member">GetInt64</h3>

```csharp
public long GetInt64(string key, long fallback = 0)
```

**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 |
|---|---|---|
| `key` | `string` |  |
| `fallback` | `long` |  · Opcional: `0` |

<h3 id="member-8404b54db388fae8" class="astra-member">GetString</h3>

```csharp
public string GetString(string key, string fallback = "")
```

**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 |
|---|---|---|
| `key` | `string` |  |
| `fallback` | `string` |  · Opcional: `` |

<h3 id="member-a5a19cd540eb0300" class="astra-member">ReadBytes</h3>

```csharp
public byte[] ReadBytes(string safeRelativePath)
```

**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 |
|---|---|---|
| `safeRelativePath` | `string` |  |

<h3 id="member-f1171b154ec5c59e" class="astra-member">ReadText</h3>

```csharp
public string ReadText(string safeRelativePath)
```

**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 |
|---|---|---|
| `safeRelativePath` | `string` |  |

<h3 id="member-d4982c73cc22deba" class="astra-member">SetBoolean</h3>

```csharp
public void SetBoolean(string key, bool value)
```

**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 |
|---|---|---|
| `key` | `string` |  |
| `value` | `bool` |  |

<h3 id="member-6e877bd43fb1abfd" class="astra-member">SetDouble</h3>

```csharp
public void SetDouble(string key, double value)
```

**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 |
|---|---|---|
| `key` | `string` |  |
| `value` | `double` |  |

<h3 id="member-3124820be3628cdd" class="astra-member">SetInt64</h3>

```csharp
public void SetInt64(string key, long value)
```

**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 |
|---|---|---|
| `key` | `string` |  |
| `value` | `long` |  |

<h3 id="member-cceabf5879d036be" class="astra-member">SetString</h3>

```csharp
public void SetString(string key, string value)
```

**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 |
|---|---|---|
| `key` | `string` |  |
| `value` | `string` |  |

<h3 id="member-908a261067b19f9c" class="astra-member">WriteBytes</h3>

```csharp
public void WriteBytes(string safeRelativePath, System.ReadOnlySpan<byte> bytes)
```

**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 |
|---|---|---|
| `safeRelativePath` | `string` |  |
| `bytes` | `System.ReadOnlySpan&lt;byte&gt;` |  |

<h3 id="member-d6d142b9d8f81142" class="astra-member">WriteText</h3>

```csharp
public void WriteText(string safeRelativePath, string text)
```

**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 |
|---|---|---|
| `safeRelativePath` | `string` |  |
| `text` | `string` |  |

<h3 id="member-f98340893693e622" class="astra-member">Recovery</h3>

```csharp
public Astra.SaveRecovery Recovery { get; private set; }
```

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

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**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.