FilePickerFileTypesOrderedMap Класс

Определение

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

Windows.Storage.Pickers

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

public ref class FilePickerFileTypesOrderedMap sealed : IIterable<IKeyValuePair<Platform::String ^, IVector<Platform::String ^> ^> ^>, IMap<Platform::String ^, IVector<Platform::String ^> ^>

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FilePickerFileTypesOrderedMap final : IIterable<IKeyValuePair<winrt::hstring, IVector<winrt::hstring> const&>>, IMap<winrt::hstring, IVector<winrt::hstring> const&>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FilePickerFileTypesOrderedMap : IDictionary<string,IList<string>>, IEnumerable<KeyValuePair<string,IList<string>>>

Public NotInheritable Class FilePickerFileTypesOrderedMap
Implements IDictionary(Of String, IList(Of String)), IEnumerable(Of KeyValuePair(Of String, IList(Of String)))

Наследование

Object Platform::Object IInspectable FilePickerFileTypesOrderedMap

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Реализации

IDictionary<String,IList<String>> IMap<Platform::String,IVector<Platform::String>> IMap<winrt::hstring,IVector<winrt::hstring>> IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>> IEnumerable<KeyValuePair<String,IList<String>>> IIterable<IKeyValuePair<Platform::String,IVector<Platform::String>>> IIterable<IKeyValuePair<winrt::hstring,IVector<winrt::hstring>>>

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

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

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";

Комментарии

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

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

Списки элементов коллекции

Для JavaScript FilePickerFileTypesOrderedMap поддерживает использование индекса для доступа к элементам.

Свойства

Size	Возвращает количество элементов в сопоставленной коллекции отображаемых имен и связанных типов файлов.

Методы

Clear()	Удаляет из коллекции все отображаемые имена и связанные расширения имен файлов.
First()	Извлекает итератор, который выполняет итерацию по отображаемым именам и связанным типам файлов в коллекции.
GetView()	Возвращает неизменяемое представление коллекции отображаемых имен и связанных типов файлов.
HasKey(String)	Определяет, содержит ли сопоставленная коллекция отображаемых имен и связанных типов файлов указанный ключ.
Insert(String, IVector<String>)	Вставляет или заменяет элемент в сопоставленной коллекции отображаемых имен и связанных типов файлов.
Lookup(String)	Возвращает элемент с указанным ключом в сопоставленной коллекции отображаемых имен и связанных типов файлов.
Remove(String)	Удаляет элемент из сопоставленной коллекции отображаемых имен и связанных типов файлов.

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

• FileTypeChoices
• Пример средства выбора файлов
• Открытие файлов и папок с помощью средства выбора