Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This example demonstrates how to use the StorageContainer class to open a save game file in the title storage area on a device specified by the gamer. This example assumes you have already obtained a StorageDevice. To obtain a StorageDevice, see How to: Get a StorageDevice Asynchronously.
To open a save game file in title storage
- Call the StorageDevice.ShowStorageDeviceGuide method to obtain a device index indicating which device the user prefers.
- Open a StorageContainer on the device, passing the name of your title.
- Call Path.Combine to merge the container path with the name of the file to be opened.
- Call File.Open with the file name of the file to open. File.Open returns a FileStream object that you can use to add data to the file.
- Close the file after you have read it.
- Dispose the StorageContainer after closing the file.
The Complete Example
// Note: Before you can build this file in a project, you must
// add a reference to System.xml. To to this, right-click
// on References in Solution Explorer and click Add Reference.
// In the .NET pane, scroll down and select System.Xml.
using System;
using System.Collections.Generic;
using Microsoft.Xna.Framework;
using Microsoft.Xna.Framework.Graphics;
using Microsoft.Xna.Framework.Input;
using Microsoft.Xna.Framework.Storage;
using System.IO;
using System.Xml.Serialization;
using Microsoft.Xna.Framework.Content;
public class Game1 : Microsoft.Xna.Framework.Game
{
GraphicsDeviceManager graphics;
ContentManager content;
public Game1()
{
graphics = new GraphicsDeviceManager( this );
content = new ContentManager( Services );
}
protected override void Initialize()
{
base.Initialize();
}
protected override void LoadGraphicsContent( bool loadAllContent )
{
if (loadAllContent)
{
// TODO: Load any ResourceManagementMode.Automatic content
}
}
protected override void UnloadGraphicsContent( bool unloadAllContent )
{
if (unloadAllContent == true)
{
content.Unload();
}
}
bool ShowingStorageDeviceGuide = false;
IAsyncResult result;
Object stateobj;
bool GameSaveRequested = false;
protected override void Update( GameTime gameTime )
{
// Allows the default game to exit on Xbox 360 and Windows
if (GamePad.GetState( PlayerIndex.One ).Buttons.Back == ButtonState.Pressed)
this.Exit();
if (GamePad.GetState( PlayerIndex.One ).Buttons.A == ButtonState.Pressed)
{
// Set the request flag
GameSaveRequested = true;
result = StorageDevice.BeginShowStorageDeviceGuide( PlayerIndex.One, null, null );
}
if (GamePad.GetState( PlayerIndex.One ).Buttons.B == ButtonState.Pressed)
{
// Reset the device
device = null;
AsyncCallback ac = new AsyncCallback( this.GetDevice );
stateobj = (Object)"GetDevice for Player One";
StorageDevice.BeginShowStorageDeviceGuide(
PlayerIndex.One, ac, stateobj );
}
// If a save is pending, save as soon as the
// storage device is chosen
if ((GameSaveRequested) && (result.IsCompleted))
{
StorageDevice device = StorageDevice.EndShowStorageDeviceGuide( result );
if (device.IsConnected)
{
DoSaveGame( device );
DoLoadGame( device );
DoCreate( device );
DoOpen( device );
DoCopy( device );
DoEnumerate( device );
DoRename( device );
DoDelete( device );
DoOpenFile();
}
// Reset the request flag
GameSaveRequested = false;
}
if (GamePad.GetState( PlayerIndex.One ).Buttons.X == ButtonState.Pressed)
{
// make sure we don't call BeginShowStorageDeviceGuide when the guide
// is already being shown
if (!ShowingStorageDeviceGuide)
{
ShowingStorageDeviceGuide = true;
// reset the device
device = null;
result = StorageDevice.BeginShowStorageDeviceGuide( PlayerIndex.One, null, null );
while (!result.IsCompleted)
{
// Call Update and Draw to draw the guide
this.Tick();
}
device = StorageDevice.EndShowStorageDeviceGuide(result);
if (device.IsConnected)
{
DoSaveGame( device );
DoLoadGame( device );
DoCreate( device );
DoOpen( device );
DoCopy( device );
DoEnumerate( device );
DoRename( device );
DoDelete( device );
DoOpenFile();
}
ShowingStorageDeviceGuide = false;
}
}
base.Update( gameTime );
}
StorageDevice device;
void GetDevice( IAsyncResult result )
{
device = StorageDevice.EndShowStorageDeviceGuide( result );
if (device.IsConnected)
{
DoSaveGame( device );
DoLoadGame( device );
DoCreate( device );
DoOpen( device );
DoCopy( device );
DoEnumerate( device );
DoRename( device );
DoDelete( device );
DoOpenFile();
}
}
protected override void Draw( GameTime gameTime )
{
graphics.GraphicsDevice.Clear( Color.CornflowerBlue );
base.Draw( gameTime );
}
[Serializable]
public struct SaveGameData
{
public string PlayerName;
public Vector2 AvatarPosition;
public int Level;
public int Score;
}
private static void DoSaveGame( StorageDevice device )
{
// Create the data to save
SaveGameData data = new SaveGameData();
data.PlayerName = "Hiro";
data.AvatarPosition = new Vector2( 360, 360 );
data.Level = 11;
data.Score = 4200;
// Open a storage container
StorageContainer container =
device.OpenContainer( "StorageDemo" );
// Get the path of the save game
string filename = Path.Combine( container.Path, "savegame.sav" );
// Open the file, creating it if necessary
FileStream stream = File.Open( filename, FileMode.OpenOrCreate );
// Convert the object to XML data and put it in the stream
XmlSerializer serializer = new XmlSerializer( typeof( SaveGameData ) );
serializer.Serialize( stream, data );
// Close the file
stream.Close();
// Dispose the container, to commit changes
container.Dispose();
}
private static void DoLoadGame( StorageDevice device )
{
// Open a storage container
StorageContainer container =
device.OpenContainer( "StorageDemo" );
// Get the path of the save game
string filename = Path.Combine( container.Path, "savegame.sav" );
// Check to see if the save exists
if (!File.Exists( filename ))
// Notify the user there is no save
return;
// Open the file
FileStream stream = File.Open( filename, FileMode.OpenOrCreate,
FileAccess.Read );
// Read the data from the file
XmlSerializer serializer = new XmlSerializer( typeof( SaveGameData ) );
SaveGameData data = (SaveGameData)serializer.Deserialize( stream );
// Close the file
stream.Close();
// Dispose the container
container.Dispose();
// Report the data to the console
Console.WriteLine( "Name: " + data.PlayerName );
Console.WriteLine( "Level: " + data.Level.ToString() );
Console.WriteLine( "Score: " + data.Score.ToString() );
Console.WriteLine( "Position: " + data.AvatarPosition.ToString() );
}
private static void DoCreate( StorageDevice device )
{
// Open a storage container
StorageContainer container =
device.OpenContainer( "StorageDemo" );
// Add the container path to our filename
string filename = Path.Combine( container.Path, "demobinary.sav" );
// Create a new file
if (!File.Exists( filename ))
{
FileStream file = File.Create( filename );
file.Close();
}
// Dispose the container, to commit the data
container.Dispose();
}
private static void DoOpen( StorageDevice device )
{
// Open a storage container
StorageContainer container =
device.OpenContainer( "StorageDemo" );
// Add the container path to our filename
string filename = Path.Combine( container.Path, "demobinary.sav" );
FileStream file = File.Open( filename, FileMode.Open );
file.Close();
// Dispose the container
container.Dispose();
}
private static void DoCopy( StorageDevice device )
{
// Open a storage container
StorageContainer container =
device.OpenContainer( "StorageDemo" );
// Add the container path to our filename
string filename = Path.Combine( container.Path, "demobinary.sav" );
string copyfilename = Path.Combine( container.Path, "copybinary.sav" );
File.Copy( filename, copyfilename, true );
// Dispose the container, to commit the change
container.Dispose();
}
private static void DoRename( StorageDevice device )
{
// Open a storage container
StorageContainer container =
device.OpenContainer( "StorageDemo" );
// Add the container path to our filename
string oldfilename = Path.Combine( container.Path, "demobinary.sav" );
string newfilename = Path.Combine( container.Path, "renamebinary.sav" );
if (!File.Exists( newfilename ))
File.Move( oldfilename, newfilename );
// Dispose the container, to commit the change
container.Dispose();
}
private static void DoEnumerate( StorageDevice device )
{
// Open a storage container
StorageContainer container =
device.OpenContainer( "StorageDemo" );
ICollection<string> FileList = Directory.GetFiles( container.Path );
// Dispose the container
container.Dispose();
}
private static void DoDelete( StorageDevice device )
{
// Open a storage container
StorageContainer container =
device.OpenContainer( "StorageDemo" );
// Add the container path to our filename
string filename = Path.Combine( container.Path, "demobinary.sav" );
// Delete the new file.
if (File.Exists( filename ))
File.Delete( filename );
// Dispose the container, to commit the change
container.Dispose();
}
private static void DoOpenFile()
{
FileStream file = OpenTitleFile(
"Sprite.dds", FileMode.Open, FileAccess.Read );
Console.WriteLine( "File Size: " + file.Length );
file.Close();
}
private static FileStream OpenTitleFile(
string filename, FileMode mode, FileAccess access )
{
string fullpath = Path.Combine( StorageContainer.TitleLocation, filename );
return File.Open( fullpath, mode, access );
}
}