FileSavePicker.FileTypeChoices Properti

Definisi

Ruang nama:

Windows.Storage.Pickers

Mendapatkan kumpulan jenis file valid yang dapat dipilih pengguna untuk ditetapkan ke 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))

Nilai Properti

IMap<String,IVector<String>>

IDictionary<String,IList<String>>

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

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

Objek FilePickerFileTypesOrderedMap yang berisi kumpulan jenis file (ekstensi) yang valid yang dapat digunakan pengguna untuk menyimpan file. Setiap elemen dalam koleksi ini memetakan nama tampilan ke kumpulan ekstensi nama file yang sesuai. Kuncinya adalah string tunggal, nilainya adalah daftar/vektor string yang mewakili satu atau beberapa pilihan ekstensi.

Contoh

Sampel Pemilih file menunjukkan cara menambahkan pilihan jenis file dengan nama tampilan.

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

Jika Anda menambahkan beberapa FileTypeChoices ke FileSavePicker, yang pertama ditambahkan adalah jenis file default. Default ini akan dipilih ketika pengguna membuka pemilih file. Tipe file default digunakan jika pengguna tidak mengubah tipe file dalam pemilih file. Dalam contoh ini, entri FileTypeChoices ditambahkan berdasarkan tombol radio mana yang telah dipilih:

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

Keterangan

Beberapa aplikasi tidak perlu memahami format file untuk memprosesnya - seperti penyedia penyimpanan cloud. Oleh karena itu, menggunakan karakter kartubebas file - "*" - didukung untuk koleksi FileOpenPicker.FileTypeFilter . Namun, menulis file membutuhkan pengetahuan tentang formatnya. Akibatnya, kartubebas tidak didukung untuk FileSavePicker.FileTypeChoices.

Satu nama tampilan sebagai klasifikasi jenis file mungkin memiliki beberapa jenis file yang mendukungnya. Misalnya, nama tampilan "halaman HTML" dapat disimpan baik dengan ekstensi ".htm" atau ".html". Itulah sebabnya nilai setiap entri dalam FilePickerFileTypesOrderedMap adalah daftar urutan (vektor) string, yang ditampilkan di UI dalam urutan anda menempatkan ekstensi di vektor.

Lihat juga

• FileSavePicker
• FilePickerFileTypesOrderedMap
• Sampel pemilih file