Windows Dev Center

FileSavePicker.FileTypeChoices | fileTypeChoices property

Gets the collection of valid file types that the user can choose to assign to a file.


Public ReadOnly Property FileTypeChoices As IDictionary(Of String, IVector<String>)

Property value

Type: IMap<String, IVector<String>> [JavaScript/C++] | System.Collections.Generic.IDictionary<String, IVector<String>> [.NET]

A FilePickerFileTypesOrderedMap object that contains a collection of valid file types (extensions) that the user can use to save a file. Each element in this collection maps a display name to a corresponding collection of file name extensions. The key is a single string, the value is a list/vector of strings representing one or more extension choices.


Some apps do not need to understand a file format in order to process it - such as a cloud storage provider. Therefore, using the file wildcard character - "*" - is supported for the FileOpenPicker.FileTypeFilter collection. However, writing a file requires knowledge of its format. As a result, the wildcard is not supported for FileSavePicker.FileTypeChoices.

One display name as a classification of file types might have multiple file types that support it. For example, a display name of "HTML page" could be saved either with ".htm" or ".html" extension. That is why the value of each entry in a FilePickerFileTypesOrderedMap is an ordered list (vector) of strings, displayed in the UI in the order that you place the extensions in the vector.


The File picker sample demonstrates how to add file type choices with a display name.

No code example is currently available or this language may not be supported.

Requirements (Windows 10 device family)

Device family


API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0


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



Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]


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



See also

File picker sample
FileSavePicker class



© 2015 Microsoft