FileSavePicker.FileTypeChoices Propiedad

Definición

Espacio de nombres:

Windows.Storage.Pickers

Obtiene la colección de tipos de archivo válidos que el usuario puede elegir asignar a un archivo.

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

Valor de propiedad

IMap<String,IVector<String>>

IDictionary<String,IList<String>>

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

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

Objeto FilePickerFileTypesOrderedMap que contiene una colección de tipos de archivo válidos (extensiones) que el usuario puede usar para guardar un archivo. Cada elemento de esta colección asigna un nombre para mostrar a una colección correspondiente de extensiones de nombre de archivo. La clave es una sola cadena, el valor es una lista o vector de cadenas que representan una o varias opciones de extensión.

Ejemplos

En el ejemplo selector de archivos se muestra cómo agregar opciones de tipo de archivo con un nombre para mostrar.

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

Si agrega varios FileTypeChoices al fileSavePicker, el primero agregado es el tipo de archivo predeterminado. Este valor predeterminado se seleccionará cuando el usuario abra el selector de archivos. El tipo de archivo predeterminado se usa si el usuario no cambia el tipo de archivo en el selector de archivos. En este ejemplo, se agregan las entradas FileTypeChoices en función del botón de radio seleccionado:

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

Comentarios

Algunas aplicaciones no necesitan comprender un formato de archivo para procesarlo, como un proveedor de almacenamiento en la nube. Por lo tanto, se admite el uso del carácter comodín de archivo -"*" para la colección FileOpenPicker.FileTypeFilter . Sin embargo, escribir un archivo requiere conocimiento de su formato. Como resultado, el carácter comodín no se admite para FileSavePicker.FileTypeChoices.

Un nombre para mostrar como una clasificación de tipos de archivo podría tener varios tipos de archivo que lo admitan. Por ejemplo, un nombre para mostrar de "página HTML" podría guardarse con la extensión ".htm" o ".html". Es por eso que el valor de cada entrada de un FilePickerFileTypesOrderedMap es una lista ordenada (vector) de cadenas, que se muestra en la interfaz de usuario en el orden en que se colocan las extensiones en el vector.

Consulte también

• FileSavePicker
• FilePickerFileTypesOrderedMap
• Ejemplo de selector de archivos