FileSavePicker.FileTypeChoices Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene la raccolta di tipi di file validi che l'utente può scegliere di assegnare a un file.
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))
Valore della proprietà
Oggetto FilePickerFileTypesOrderedMap che contiene una raccolta di tipi di file validi (estensioni) che l'utente può usare per salvare un file. Ogni elemento di questa raccolta esegue il mapping di un nome visualizzato a una raccolta corrispondente di estensioni di file. La chiave è una singola stringa, il valore è un elenco/vettore di stringhe che rappresenta una o più opzioni di estensione.
Esempio
L'esempio di selezione file illustra come aggiungere scelte di tipo file con un nome visualizzato.
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");
Se si aggiungono più fileTypeChoice a FileSavePicker, il primo aggiunto è il tipo di file predefinito. Questa impostazione predefinita verrà selezionata quando l'utente apre la selezione file. Il tipo di file predefinito viene utilizzato se l'utente non modifica il tipo di file nella selezione file. In questo esempio, le voci FileTypeChoices vengono aggiunte in base al pulsante di opzione selezionato:
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" });
}
Commenti
Alcune app non devono comprendere un formato di file per elaborarlo, ad esempio un provider di archiviazione cloud. Pertanto, l'uso del carattere jolly del file , "*", è supportato per l'insieme FileOpenPicker.FileTypeFilter . Tuttavia, la scrittura di un file richiede la conoscenza del relativo formato. Di conseguenza, il carattere jolly non è supportato per FileSavePicker.FileTypeChoices.
Un nome visualizzato come classificazione dei tipi di file potrebbe avere più tipi di file che lo supportano. Ad esempio, è possibile salvare un nome visualizzato di "pagina HTML" con estensione ".htm" o ".html". Per questo motivo, il valore di ogni voce in un oggetto FilePickerFileTypesOrderedMap è un elenco ordinato (vettore) di stringhe, visualizzato nell'interfaccia utente nell'ordine in cui si inseriscono le estensioni nel vettore.