> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft.Xbox.Wrappers.XGameSave.Provider 參考

> Microsoft.Xbox.Wrappers.XGameSave.Provider 類別的參考資料，這是用於初始化、載入、儲存及查詢存檔容器的主要管理類型。

# Microsoft.Xbox.Wrappers.XGameSave.Provider

**XGameSave** 包裝函式的主要管理類別。

## 語法

```cpp theme={null}
class Provider
```

## 方法

| 方法 | 描述 |
| - | - |
| [Initialize](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md) | 初始化遊戲存檔包裝函式，並同步處理指定使用者的所有容器。 |
| [QueryContainers](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainers.md) | 傳回符合所提供名稱前置詞的容器名稱向量。 |
| [QueryContainerBlobs](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainerblobs.md) | 傳回 [BlobInfo](https://docs.xbox.com/zh-TW/reference/system/Wrappers/structs/blobinfo.md) 物件的向量，用以識別指定容器中的 Blob (檔案)。 |
| [Load](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load.md) | 從指定的容器中載入指定 Blob (檔案) 的資料。 |
| [Save](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md) | 將資料儲存到指定容器內的指定 Blob (檔案)。 |
| [GetQuota](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_getquota.md) | 傳回可使用遊戲存檔包裝函式儲存的資料量。 |
| [Delete(std::string&)](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string.md) | 刪除容器及其所有 Blob (檔案)。 |
| [Delete(std::string&, std::string&)](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_string.md) | 從指定的容器中刪除指定的 Blob (檔案)。 |
| [Delete(std::string&, BlobNames&)](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_blobnames.md) | 從指定的容器中刪除一或多個 Blob (檔案)。 |

## 備註

**XGameSave** 簡化包裝函式是一組 API，可代表使用者讀取和寫入資料，讓資料在遊戲工作階段之間保存，並跨多部裝置與雲端順暢同步。包裝函式 API 分為三類：

**提供者**

`gs_provider_t` 是將使用者內容繫結至遊戲存檔的控制代碼。API 互動需要用到它。每個提供者可以包含多個容器，而每個提供者的預設配額為 256 MB。提供者作業包括：

* 配額資訊
* 容器管理
* 提供者中繼資料 (服務設定識別碼、UserContext)

**容器**

您可以使用容器，以邏輯方式將資料關聯成一個群組，並以不可部分完成的方式寫入、更新和讀取。容器作業包括：

* 查詢容器資訊和容器狀態
* 查詢容器內容
* 以不可部分完成的方式更新容器資料

**二進位大型物件 (Blob)**

Blob 包含容器內所含的資料。一個 Blob 可包含的資料量上限為 16 MB。

* Blob 更新和刪除作業設計為不可部分完成，因此一組變更可在單一作業中認可。如果任何部分失敗，則整個更新都會失敗。

## 需求

**標頭：** xgamesavewrappers.hpp

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[Microsoft.Xbox.Wrappers.XGameSave.Provider](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/xgamesave_wrapper_provider.md)\
[XGameSave 包裝函式成員](https://docs.xbox.com/zh-TW/reference/system/Wrappers/xgamesave_wrapper_members.md)\
[觀察者設計模式](https://learn.microsoft.com/dotnet/standard/events/observer-design-pattern)


## Related topics

- [Save](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [Initialize](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md)
- [Load](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load.md)
- [Delete(std::string&)](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string.md)
- [QueryContainers](https://docs.xbox.com/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainers.md)