FilePickerFileTypesOrderedMap Klasse

  • Referenz

Definition

Namespace:
Windows.Storage.Pickers
Bearbeiten

Stellt eine Auflistung von Anzeigenamen dar, die den zugeordneten Dateitypen (Erweiterungen) zugeordnet sind. Jedes Element in dieser Auflistung ordnet einen Anzeigenamen einer entsprechenden Auflistung von Dateinamenerweiterungen zu. Der Schlüssel ist eine einzelne Zeichenfolge. Der Wert ist eine Liste/ein Vektor von Zeichenfolgen, die eine oder mehrere Erweiterungsoptionen darstellen.

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)))
Vererbung
Object Platform::Object IInspectable FilePickerFileTypesOrderedMap
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute
Implementiert
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-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Das Beispiel für die Dateiauswahl veranschaulicht, wie Dateitypauswahlen mit einem Anzeigenamen hinzugefügt werden.

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

Hinweise

Instanzen der FilePickerFileTypesOrderedMap-Klasse geben den Wert für die FileSavePicker.FileTypeChoices-Eigenschaft an. Durch strikte Eingabe übernimmt die FileTypeChoices-Eigenschaft eine generische Zuordnung, bei der der Wert ein generischer Vektor von Zeichenfolgen ist. Die FilePickerFileTypesOrderedMap-Klasse implementiert diese Kombination von Schnittstellen jedoch als konkrete Klasse. Daher sollten Sie immer ein FilePickerFileTypesOrderedMap-Objekt für einen FileTypeChoices-Wert verwenden.

Der Schlüssel für einen Eintrag in einer FilePickerFileTypesOrderedMap ist eine Zeichenfolge, die eine Anzeigename-Klassifizierung darstellt, für die ein Dateityp vorgesehen ist. Beispielsweise ist "Nur Text" ein geeigneter Schlüssel für eine FilePickerFileTypesOrderedMap, bei der eine der zugeordneten Dateityperweiterungen ".txt" ist. Ein Anzeigename als Klassifizierung von Dateitypen kann mehrere Dateitypen aufweisen, die ihn unterstützen. Beispielsweise könnte ein Anzeigename der "HTML-Seite" entweder mit der Erweiterung ".htm" oder ".html" gespeichert werden. Aus diesem Grund ist der Wert jedes Eintrags in einer FilePickerFileTypesOrderedMap eine sortierte Liste (Vektor) von Zeichenfolgen, die in der Benutzeroberfläche in der Reihenfolge angezeigt wird, in der Sie die Erweiterungen im Vektor platzieren.

Auflistungsmemberlisten

Für JavaScript unterstützt FilePickerFileTypesOrderedMap die Verwendung eines Indexes für den Zugriff auf Elemente.

Eigenschaften

Size

Ruft die Anzahl der Elemente in der zugeordneten Auflistung von Anzeigenamen und zugeordneten Dateitypen ab.

Methoden

Clear()

Entfernt alle Anzeigenamen und zugehörigen Dateinamenerweiterungen aus der Auflistung.
First()

Ruft einen Iterator ab, der die Anzeigenamen und zugehörigen Dateitypen in der Auflistung durchläuft.
GetView()

Gibt eine unveränderliche Ansicht der Auflistung von Anzeigenamen und zugeordneten Dateitypen zurück.
HasKey(String)

Bestimmt, ob die zugeordnete Auflistung von Anzeigenamen und zugeordneten Dateitypen den angegebenen Schlüssel enthält.
Insert(String, IVector<String>)

Fügt ein Element in die zugeordnete Auflistung von Anzeigenamen und zugeordneten Dateitypen ein oder ersetzt es.
Lookup(String)

Gibt das Element am angegebenen Schlüssel in der zugeordneten Auflistung von Anzeigenamen und zugeordneten Dateitypen zurück.
Remove(String)

Entfernt ein Element aus der zugeordneten Auflistung von Anzeigenamen und zugeordneten Dateitypen.

Gilt für:

Weitere Informationen