GameSaveContainer Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Enthält eine Sammlung von Datenblobs, die ein einzelnes gespeichertes Spiel darstellen.
public ref class GameSaveContainer sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Gaming.XboxLive.StorageApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class GameSaveContainer final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Gaming.XboxLive.StorageApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class GameSaveContainer
Public NotInheritable Class GameSaveContainer
- Vererbung
- Attribute
Windows-Anforderungen
Gerätefamilie |
Xbox Live Extension SDK (eingeführt in 10.0.10240.0)
Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0) |
API contract |
Windows.Gaming.XboxLive.StorageApiContract (eingeführt in v1.0)
|
Hinweise
Ein GameSaveContainer stellt ein einzelnes gespeichertes Spiel dar und besteht aus einer Sammlung von Datenblobs, die die Spieldaten enthalten und unabhängig beschreibbar sind.
Wichtig
Diese API richtet sich an UWP-Spiele und -Apps mit Xbox Live-Aktivierung. Aufrufe dieser APIs von Quellen, die nicht Xbox Live aktiviert sind, können keine Daten mit der Cloud synchronisieren.
Eigenschaften
Name |
Der Name dieses GameSaveContainer. |
Provider |
Der Anbieter, in dem dieser Container gespeichert ist. |
Methoden
CreateBlobInfoQuery(String) |
Erstellt einen GameSaveBlobInfoQuery-instance, der die Spielspeicherblobs innerhalb dieses Containers mit Namen abruft, die mit dem angegebenen Präfix beginnen. |
GetAsync(IIterable<String>) |
Ruft Blobs asynchron aus dem Container ab. |
ReadAsync(IMapView<String,IBuffer>) |
Liest Blobs aus diesem Container, wie in blobsToRead angegeben. Die in blobsToRead übergebenen Puffer müssen groß genug sein, um die Blobdaten zu speichern. |
SubmitPropertySetUpdatesAsync(IPropertySet, IIterable<String>, String) |
Ähnlich wie SubmitUpdatesAsync, mit der Ausnahme, dass diese Methode für ein PropertySet anstelle einer zugeordneten Ansicht (oder eines Wörterbuchs in C#) verwendet wird. |
SubmitUpdatesAsync(IMapView<String,IBuffer>, IIterable<String>, String) |
Übermittelt eine Reihe von Änderungen an den Spielspeicherblobs in diesem Container. Änderungen können Schreibvorgänge in Blobs oder das Löschen vorhandener Blobs sein. Wenn der Container nicht vorhanden ist, wird ein neuer Container erstellt. Alle Schreibvorgänge und Updates werden atomar angewendet. Der Versuch, dasselbe Blob zu schreiben und zu löschen, führt zu einem Fehler. Pro Anruf dürfen nur 16 MB Daten geschrieben werden. |