FilePickerFileTypesOrderedMap クラス

定義

名前空間:

Windows.Storage.Pickers

関連付けられたファイルの種類 (拡張子) にマップされた表示名のコレクションを表します。 このコレクション内の各要素は、表示名をファイル名拡張子の対応するコレクションにマップします。 キーは 1 つの文字列で、値は 1 つ以上の拡張選択肢を表す文字列のリスト/ベクターです。

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 の適切なキーであり、関連付けられているファイルの種類の拡張子の 1 つが ".txt" です。ファイルの種類の分類として 1 つの表示名には、それをサポートする複数のファイルの種類が含まれる場合があります。 たとえば、"HTML ページ" の表示名は、".htm" または ".html" 拡張子で保存できます。 そのため、FilePickerFileTypesOrderedMap 内の各エントリの値は、文字列の順序付きリスト (ベクター) であり、拡張をベクターに配置する順序で UI に表示されます。

コレクション メンバー リスト

JavaScript の場合、FilePickerFileTypesOrderedMap では、インデックスを使用して項目にアクセスできます。

プロパティ

Size	表示名と関連付けられたファイルの種類のマップされたコレクション内の項目の数を取得します。

メソッド

Clear()	コレクションからすべての表示名と関連付けられているファイル名拡張子を削除します。
First()	コレクション内の表示名と関連付けられたファイルの種類を反復処理する反復子を取得します。
GetView()	表示名と関連付けられたファイルの種類のコレクションの変更できないビューを返します。
HasKey(String)	表示名と関連付けられたファイルの種類のマップされたコレクションに、指定したキーが含まれているかどうかを判断します。
Insert(String, IVector<String>)	表示名と関連するファイルの種類のマップされたコレクション内の項目を挿入または置換します。
Lookup(String)	表示名と関連付けられたファイルの種類のマップされたコレクション内の指定したキーにある項目を返します。
Remove(String)	表示名と関連するファイルの種類のマップされたコレクションから項目を削除します。

こちらもご覧ください

• FileTypeChoices
• ファイル ピッカーのサンプル
• ピッカーでファイルやフォルダーを開く