How To: Rename a File

Demonstrates how to use the StorageContainer class to rename a save game file in the title storage area on a device specified by the gamer. This example assumes you obtained a StorageDevice. To obtain a StorageDevice, see How To: Get a StorageDevice Asynchronously.

The Complete Sample

The code in the topic shows you the technique. You can download a complete code sample for this topic, including full source code and any additional supporting files required by the sample.

Renaming a File

To rename a save game file in title storage

  1. Call the Guide.BeginShowStorageDeviceSelector method to get a device index indicating which device the user prefers.

  2. Open a StorageContainer on the device, and then pass the name of your title.

  3. Call Path.Combine to merge the container path with the name of the source and destination files.

  4. Call File.Exists to confirm that the destination file does not exist.

  5. Call File.Move with the name of the file to rename, and the new name of the file.

  6. Dispose the StorageContainer to commit the changes to the device.

private static void DoRename(StorageDevice device)
    // Open a storage container.
    StorageContainer container =

    // Add the container path to our file name.
    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