FileSavePicker.PickSaveFileAsync | pickSaveFileAsync method

Applies to Windows only

Shows the file picker so that the user can save a file and set the file name, extension, and location of the file to be saved. (Windows Store apps)


fileSavePicker.pickSaveFileAsync().done( /* Your success and error handlers */ );


This method has no parameters.

Return value

Type: IAsyncOperation<StorageFile>

When the call to this method completes successfully, it returns a storageFile object that was created to represent the saved file. The file name, extension, and location of this storageFile match those specified by the user, but the file has no content.

To save the content of the file, your app must write the content to this storageFile.


Warning  If you try to show the file picker while your app is snapped the file picker will not be shown and an exception will be thrown. You can avoid this by making sure your app is not snapped or by unsnapping it before you call the file picker. The code examples in FileSavePicker and the File picker sample show you how.


Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

None supported


Windows::Storage::Pickers [C++]



See also

FileSavePicker class



© 2014 Microsoft