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 类将接口组合作为具体类实现，因此应始终将 FilePickerFileTypesOrderedMap 对象用于 FileTypeChoices 值。

FilePickerFileTypesOrderedMap 中条目的键是一个字符串，表示文件类型的友好名称/显示名称分类。 例如，“纯文本”是 FilePickerFileTypesOrderedMap 的相应键，其中一个关联的文件类型扩展名为“.txt”。一个显示名称作为文件类型的分类可能有多个支持它的文件类型。 例如，可以使用“.htm”或“.html”扩展名保存“HTML 页面”的显示名称。 这就是为什么 FilePickerFileTypesOrderedMap 中每个条目的值都是字符串向量) (有序列表，在 UI 中按在向量中放置扩展的顺序显示。

集合成员列表

对于 JavaScript，FilePickerFileTypesOrderedMap 支持使用索引来访问项。

属性

Size	获取显示名称和关联文件类型的映射集合中的项数。

方法

Clear()	从集合中删除所有显示名称和关联的文件扩展名。
First()	检索循环访问集合中显示名称和关联的文件类型的迭代器。
GetView()	返回显示名称和关联文件类型集合的不可变视图。
HasKey(String)	确定显示名称和关联文件类型的映射集合是否包含指定的键。
Insert(String, IVector<String>)	插入或替换显示名称和关联文件类型的映射集合中的项。
Lookup(String)	返回显示名称和关联文件类型的映射集合中指定键处的项。
Remove(String)	从显示名称和关联文件类型的映射集合中删除项。

另请参阅

• FileTypeChoices
• 文件选取器示例
• 使用选取器打开文件和文件夹