FileSavePicker.FileTypeChoices Eigenschaft

Definition

Namespace:

Windows.Storage.Pickers

Ruft die Auflistung gültiger Dateitypen ab, die der Benutzer einer Datei zuweisen kann.

public:
 property IMap<Platform::String ^, IVector<Platform::String ^> ^> ^ FileTypeChoices { IMap<Platform::String ^, IVector<Platform::String ^> ^> ^ get(); };

IMap<winrt::hstring, IVector<winrt::hstring> const&> FileTypeChoices();

public IDictionary<string,IList<string>> FileTypeChoices { get; }

var iMap = fileSavePicker.fileTypeChoices;

Public ReadOnly Property FileTypeChoices As IDictionary(Of String, IList(Of String))

Eigenschaftswert

IMap<String,IVector<String>>

IDictionary<String,IList<String>>

IMap<Platform::String,IVector<Platform::String>>

IMap<winrt::hstring,IVector<winrt::hstring>>

Ein FilePickerFileTypesOrderedMap-Objekt , das eine Auflistung gültiger Dateitypen (Erweiterungen) enthält, die der Benutzer zum Speichern einer Datei verwenden kann. 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.

Beispiele

Das Beispiel für die Dateiauswahl veranschaulicht, wie Dateitypoptionen 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";

auto plainTextExtensions{ winrt::single_threaded_vector<winrt::hstring>() };
plainTextExtensions.Append(L".txt");

savePicker.FileTypeChoices().Insert(L"Plain Text", plainTextExtensions);
savePicker.SuggestedFileName(L"New Document");

Wenn Sie dem FileSavePicker mehrere FileTypeChoices hinzufügen, wird zuerst der Standarddateityp hinzugefügt. Diese Standardeinstellung wird ausgewählt, wenn der Benutzer die Dateiauswahl öffnet. Der Standarddateityp wird verwendet, wenn der Benutzer den Dateityp in der Dateiauswahl nicht ändert. In diesem Beispiel werden die FileTypeChoices-Einträge basierend auf dem ausgewählten Optionsfeld hinzugefügt:

if (radioButtonRichText.IsChecked)
{
    savePicker.FileTypeChoices.Add("Rich text", new List<string>() { ".rtf" });
    savePicker.FileTypeChoices.Add("Word document", new List<string>() { ".docx" });
    savePicker.FileTypeChoices.Add("Plain text", new List<string>() { ".txt" });
}
else if (radioButtonWordDoc.IsChecked)
{
    savePicker.FileTypeChoices.Add("Word document", new List<string>() { ".docx" });
    savePicker.FileTypeChoices.Add("Plain text", new List<string>() { ".txt" });
    savePicker.FileTypeChoices.Add("Rich text", new List<string>() { ".rtf" });
}
else // default to plain text file type
{
    savePicker.FileTypeChoices.Add("Plain text", new List<string>() { ".txt" });
    savePicker.FileTypeChoices.Add("Rich text", new List<string>() { ".rtf" });
    savePicker.FileTypeChoices.Add("Word document", new List<string>() { ".docx" });
}

Hinweise

Einige Apps müssen kein Dateiformat verstehen, um es verarbeiten zu können, z. B. ein Cloudspeicheranbieter. Daher wird die Verwendung des Dateiplatzhalterzeichens "*" für die FileOpenPicker.FileTypeFilter-Auflistung unterstützt. Das Schreiben einer Datei erfordert jedoch Kenntnisse über ihr Format. Daher wird der Wildcard für FileSavePicker.FileTypeChoices nicht unterstützt.

Ein Anzeigename als Klassifizierung von Dateitypen kann mehrere Dateitypen aufweisen, die ihn unterstützen. Beispielsweise könnte der Anzeigename "HTML-Seite" entweder mit der Erweiterung ".htm" oder ".html" gespeichert werden. Aus diesem Grund ist der Wert jedes Eintrags in einem FilePickerFileTypesOrderedMap eine sortierte Liste (Vektor) von Zeichenfolgen, die auf der Benutzeroberfläche in der Reihenfolge angezeigt wird, in der Sie die Erweiterungen im Vektor platzieren.

Weitere Informationen

• FileSavePicker
• FilePickerFileTypesOrderedMap
• Beispiel zur Dateiauswahl