FileSavePicker.FileTypeChoices Свойство

Определение

Пространство имен:

Windows.Storage.Pickers

Возвращает коллекцию допустимых типов файлов, которые пользователь может назначить файлу.

public:
 property IMap<Platform::String ^, IVector<Platform::String ^> ^> ^ FileTypeChoices { IMap<Platform::String ^, IVector<Platform::String ^> ^> ^ get(); };

IMap<winrt::hstring, IVector<winrt::hstring> const&> FileTypeChoices();

public IDictionary<string,IList<string>> FileTypeChoices { get; }

var iMap = fileSavePicker.fileTypeChoices;

Public ReadOnly Property FileTypeChoices As IDictionary(Of String, IList(Of String))

Значение свойства

IMap<String,IVector<String>>

IDictionary<String,IList<String>>

IMap<Platform::String,IVector<Platform::String>>

IMap<winrt::hstring,IVector<winrt::hstring>>

Объект FilePickerFileTypesOrderedMap , содержащий коллекцию допустимых типов файлов (расширений), которые пользователь может использовать для сохранения файла. Каждый элемент в этой коллекции сопоставляет отображаемое имя с соответствующей коллекцией расширений имен файлов. Ключ — это одна строка, значение — это список или вектор строк, представляющих один или несколько вариантов расширения.

Примеры

В примере средства выбора файлов показано, как добавить варианты типов файлов с отображаемым именем.

FileSavePicker savePicker = new FileSavePicker();
savePicker.SuggestedStartLocation = PickerLocationId.DocumentsLibrary;
// Dropdown of file types the user can save the file as
savePicker.FileTypeChoices.Add("Plain Text", new List<string>() { ".txt" });
// Default file name if the user does not type one in or select a file to replace
savePicker.SuggestedFileName = "New Document";

auto plainTextExtensions{ winrt::single_threaded_vector<winrt::hstring>() };
plainTextExtensions.Append(L".txt");

savePicker.FileTypeChoices().Insert(L"Plain Text", plainTextExtensions);
savePicker.SuggestedFileName(L"New Document");

При добавлении нескольких объектов FileTypeChoices в FileSavePicker первый добавлен тип файла будет типом файла по умолчанию. Это значение по умолчанию будет выбрано при открытии пользователем средства выбора файлов. Тип файла по умолчанию используется, если пользователь не изменяет тип файла в средства выбора файлов. В этом примере записи FileTypeChoices добавляются в зависимости от выбранного переключателя:

if (radioButtonRichText.IsChecked)
{
    savePicker.FileTypeChoices.Add("Rich text", new List<string>() { ".rtf" });
    savePicker.FileTypeChoices.Add("Word document", new List<string>() { ".docx" });
    savePicker.FileTypeChoices.Add("Plain text", new List<string>() { ".txt" });
}
else if (radioButtonWordDoc.IsChecked)
{
    savePicker.FileTypeChoices.Add("Word document", new List<string>() { ".docx" });
    savePicker.FileTypeChoices.Add("Plain text", new List<string>() { ".txt" });
    savePicker.FileTypeChoices.Add("Rich text", new List<string>() { ".rtf" });
}
else // default to plain text file type
{
    savePicker.FileTypeChoices.Add("Plain text", new List<string>() { ".txt" });
    savePicker.FileTypeChoices.Add("Rich text", new List<string>() { ".rtf" });
    savePicker.FileTypeChoices.Add("Word document", new List<string>() { ".docx" });
}

Комментарии

Некоторые приложения не должны понимать формат файла для его обработки, например поставщик облачных хранилищ. Поэтому для коллекции FileOpenPicker.FileTypeFilter поддерживается использование подстановочного знака файла — "*". Однако для написания файла требуется знание его формата. В результате подстановочный знак не поддерживается для FileSavePicker.FileTypeChoices.

Одно отображаемое имя в качестве классификации типов файлов может иметь несколько типов файлов, поддерживающих его. Например, отображаемое имя "HTML-страница" можно сохранить с расширением ".htm" или ".html". Поэтому значение каждой записи в FilePickerFileTypesOrderedMap представляет собой упорядоченный список (вектор) строк, отображаемый в пользовательском интерфейсе в том порядке, в котором расширения помещаются в векторе.

См. также раздел

• FileSavePicker
• FilePickerFileTypesOrderedMap
• Пример средства выбора файлов