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

# XGameSave Provider Load 方法參考

> XGameSave 包裝函式 Provider.Load 方法的參考資料，此方法會將存檔容器中具名 Blob (檔案) 的位元組讀取到遊戲記憶體中。

# Microsoft.Xbox.Wrappers.XGameSave.Provider.Load

從指定的容器中載入指定 Blob (檔案) 的資料。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
BlobData Load(const std::string& containerName,
              const std::string& blobName );
```

<a id="parametersSection" />

### 參數

*containerName*   \_In\_<br />類型：std::string

容器的名稱。

*blobName*  \_In\_<br />類型：std::string

要從中載入資料的 Blob 名稱。

<a id="retvalSection" />

### 傳回值

類型：BlobData

此方法會傳回一個向量，其中包含 Blob 內容的逐位元組複本。

<a id="exampleSection" />

### 範例

下列範例程式碼示範如何使用 **Load** 方法。

```cpp theme={null}
using Microsoft::Xbox::Wrappers::GameSave;

Provider provider = new Provider();

if(SUCCEEDED(provider->Initialize(userHandle, mySCID))
{
   std::vector<std::string> containers = provider->QueryContainers("Save slot 1");
   
   if(containers.size() == 1)
   {
      BlobData data = provider->Load("Save_slot_1", "progress");
      
      if(!data.empty())
      {
         // Read the data into the game.
      }
      else
      {
         // Unexpected because there should be
         // only one blob in the container.
      }
   }
}
```

<a id="remarksSection" />

## 備註

如果您在 UI 執行緒上呼叫此方法，它會擲回例外狀況。

如果找不到符合容器和 Blob 名稱的項目，則傳回的向量會是空的。

您必須先呼叫 [Initialize](/zh-TW/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize) 方法，才能呼叫 `Provider` 類別中的任何其他方法。

<a id="requirementsSection" />

## 需求

**標頭：** xgamesavewrappers.hpp

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

<a id="seealsoSection" />

## 另請參閱

[Microsoft.Xbox.Wrappers.XGameSave.Provider](/zh-TW/reference/system/Wrappers/classes/provider/xgamesave_wrapper_provider)<br />[XGameSave 包裝函式成員](/zh-TW/reference/system/Wrappers/xgamesave_wrapper_members)


## Related topics

- [Load](/zh-CN/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load.md)
- [XGameSave Provider Load method reference](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load.md)
- [Referencia del método Load de XGameSave Provider](/es/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load.md)
- [Save](/zh-CN/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [XGameSave Provider Save method reference](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)