FilePickerFileTypesOrderedMap Classe

Définition

Espace de noms:

Windows.Storage.Pickers

Représente une collection de noms d’affichage mappés aux types de fichiers (extensions) associés. Chaque élément de cette collection mappe un nom d’affichage à une collection correspondante d’extensions de nom de fichier. La clé est une chaîne unique, la valeur est une liste/vecteur de chaînes représentant un ou plusieurs choix d’extension.

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)))

Héritage

Object Platform::Object IInspectable FilePickerFileTypesOrderedMap

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

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

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple de sélecteur de fichiers montre comment ajouter des choix de type de fichier avec un nom d’affichage.

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

Remarques

Les instances de la classe FilePickerFileTypesOrderedMap fournissent la valeur de la propriété FileSavePicker.FileTypeChoices . En tapant strictement, la propriété FileTypeChoices prend une carte générique où la valeur est un vecteur générique de chaînes. Toutefois, la classe FilePickerFileTypesOrderedMap implémente cette combinaison d’interfaces en tant que classe concrète. Vous devez donc toujours utiliser un objet FilePickerFileTypesOrderedMap pour une valeur FileTypeChoices .

La clé d’une entrée dans un FilePickerFileTypesOrderedMap est une chaîne qui représente une classification friendly-name/displayname de ce à quoi un type de fichier est destiné. Par exemple, « Texte brut » est une clé appropriée pour un FilePickerFileTypesOrderedMap où l’une des extensions de type de fichier associées est « .txt ». Un nom d’affichage en tant que classification de types de fichiers peut avoir plusieurs types de fichiers qui le prennent en charge. Par exemple, un nom d’affichage de « page HTML » peut être enregistré avec l’extension « .htm » ou « .html ». C’est pourquoi la valeur de chaque entrée d’un FilePickerFileTypesOrderedMap est une liste ordonnée (vecteur) de chaînes, affichée dans l’interface utilisateur dans l’ordre dans lequel vous placez les extensions dans le vecteur.

Listes de membres de la collection

Pour JavaScript, FilePickerFileTypesOrderedMap prend en charge l’utilisation d’un index pour accéder aux éléments.

Propriétés

Size	Obtient le nombre d’éléments dans la collection mappée de noms d’affichage et de types de fichiers associés.

Méthodes

Clear()	Supprime tous les noms d’affichage et les extensions de nom de fichier associées de la collection.
First()	Récupère un itérateur qui itère à travers les noms d’affichage et les types de fichiers associés dans la collection.
GetView()	Retourne une vue immuable de la collection de noms d’affichage et de types de fichiers associés.
HasKey(String)	Détermine si la collection mappée de noms d’affichage et de types de fichiers associés contient la clé spécifiée.
Insert(String, IVector<String>)	Insère ou remplace un élément dans la collection mappée de noms d’affichage et de types de fichiers associés.
Lookup(String)	Retourne l’élément à la clé spécifiée dans la collection mappée de noms d’affichage et de types de fichiers associés.
Remove(String)	Supprime un élément de la collection mappée de noms d’affichage et de types de fichiers associés.

Voir aussi

• FileTypeChoices
• Exemple de sélecteur de fichiers
• Ouvrir des fichiers et des dossiers à l’aide d’un sélecteur