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)]
class FilePickerFileTypesOrderedMap final : IIterable<IKeyValuePair<winrt::hstring, IVector<winrt::hstring> const&>>, IMap<winrt::hstring, IVector<winrt::hstring> const&>
/// [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)]
public sealed class FilePickerFileTypesOrderedMap : IDictionary<string,IList<string>>, IEnumerable<KeyValuePair<string,IList<string>>>
[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」。一個顯示為檔案類型分類的顯示名稱可能會有多個支援它的檔案類型。 例如，可以使用 「.htm」 或 「.html」 延伸模組來儲存 「HTML 頁面」 的顯示名稱。 這就是為什麼 FilePickerFileTypesOrderedMap 中的每個專案值都是一個已排序的清單 (向量) 字串，以您在向量中放置延伸模組的順序顯示在 UI 中。

集合成員清單

針對 JavaScript，FilePickerFileTypesOrderedMap 支援使用索引來存取專案。

屬性

Size

取得顯示名稱和相關聯檔案類型之對應集合中的專案數目。

方法

Clear()

從集合中移除所有顯示名稱和相關聯的副檔名。
First()

擷取反覆運算器，逐一查看集合中的顯示名稱和相關聯的檔案類型。
GetView()

傳回顯示名稱和相關聯檔案類型集合的不可變檢視。
HasKey(String)

判斷顯示名稱和相關聯檔案類型的對應集合是否包含指定的索引鍵。
Insert(String, IVector<String>)

在顯示名稱和相關聯檔案類型的對應集合中插入或取代專案。
Lookup(String)

傳回對應集合中顯示名稱和相關聯檔案類型之指定索引鍵的專案。
Remove(String)

從顯示名稱和相關聯檔案類型的對應集合中移除專案。

適用於

另請參閱