GameSaveProvider.CreateContainer(String) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

建立新的 GameSaveContainer 來儲存遊戲儲存。

public:
 virtual GameSaveContainer ^ CreateContainer(Platform::String ^ name) = CreateContainer;

GameSaveContainer CreateContainer(winrt::hstring const& name);

public GameSaveContainer CreateContainer(string name);

function createContainer(name)

Public Function CreateContainer (name As String) As GameSaveContainer

類型：字串 [JavaScript] | System.String [.NET] | Platform：：String [C++]

新遊戲儲存容器的名稱。容器名稱的最大長度為 256 個字元。

名為 GameSaveContainer 實例的新空白實例。

容器名稱 (路徑部分的有效字元，且包含最終正斜線) 包含大寫字母 (A-Z) 、小寫字母 (a-z) 、數位 (0-9) 、底線 (_) 和正斜線 (/) 。路徑部分可能是空的。

檔案名部分的有效字元 (最後斜線之後的所有專案) 包含大寫字母 (A-Z) 、小寫字母 (a-z) 、數位 (0-9) 、底線 (_) 、句點 (.) 和連字號 ( ) 。檔案名可能不是空的、以句號結尾，或包含兩個連續的句點。

如果 name 無效，則作業會失敗，並出現 GameSaveErrorStatus.InvalidContainerName。

名稱中指定的字串是用來以程式設計方式參照遊戲儲存，而不是向使用者顯示的顯示名稱。

傳回的 GameSaveContainer 是空的，而且不包含任何遊戲儲存 Blob。

使用 GameSaveContainer.SubmitUpdatesAsync 將遊戲儲存 Blob 寫入容器。