FileSavePicker.FileTypeChoices Propriedade

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

Um objeto FilePickerFileTypesOrderedMap que contém uma coleção de tipos de arquivo válidos (extensões) que o usuário pode usar para salvar um arquivo. Cada elemento nesta coleção mapeia um nome de exibição para uma coleção correspondente de extensões de nome de arquivo. A chave é uma única cadeia de caracteres, o valor é uma lista/vetor de cadeias de caracteres que representam uma ou mais opções de extensão.

Exemplos

O exemplo do seletor de arquivos demonstra como adicionar opções de tipo de arquivo com um nome de exibição.

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 você adicionar vários FileTypeChoices ao FileSavePicker, o primeiro adicionado será o tipo de arquivo padrão. Esse padrão será selecionado quando o usuário abrir o seletor de arquivos. O tipo de arquivo padrão será usado se o usuário não alterar o tipo de arquivo no seletor de arquivos. Neste exemplo, as entradas FileTypeChoices são adicionadas com base em qual botão de opção foi selecionado:

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

Comentários

Alguns aplicativos não precisam entender um formato de arquivo para processá-lo , como um provedor de armazenamento em nuvem. Portanto, o uso do caractere curinga do arquivo - "*" - é compatível com a coleção FileOpenPicker.FileTypeFilter . No entanto, escrever um arquivo requer conhecimento de seu formato. Como resultado, não há suporte para o curinga para FileSavePicker.FileTypeChoices.

Um nome de exibição como uma classificação de tipos de arquivo pode ter vários tipos de arquivo que dão suporte a ele. Por exemplo, um nome de exibição de "página HTML" pode ser salvo com a extensão ".htm" ou ".html". É por isso que o valor de cada entrada em um FilePickerFileTypesOrderedMap é uma lista ordenada (vetor) de cadeias de caracteres, exibida na interface do usuário, na ordem em que você coloca as extensões no vetor.

Aplica-se a

Confira também

• FileSavePicker
• FilePickerFileTypesOrderedMap
• Exemplo do seletor de arquivos