FileOpenPicker Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili elemen UI yang memungkinkan pengguna memilih dan membuka file.
Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.
public ref class FileOpenPicker sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileOpenPicker final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class FileOpenPicker final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FileOpenPicker final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileOpenPicker
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class FileOpenPicker
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class FileOpenPicker
function FileOpenPicker()
Public NotInheritable Class FileOpenPicker
- Warisan
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Contoh
Sampel Pemilih file menunjukkan cara memeriksa apakah aplikasi diciutkan, cara mengatur properti pemilih file, dan cara menampilkan pemilih file sehingga pengguna dapat memilih satu file.
FileOpenPicker openPicker = new FileOpenPicker();
openPicker.ViewMode = PickerViewMode.Thumbnail;
openPicker.SuggestedStartLocation = PickerLocationId.PicturesLibrary;
openPicker.FileTypeFilter.Add(".jpg");
openPicker.FileTypeFilter.Add(".jpeg");
openPicker.FileTypeFilter.Add(".png");
StorageFile file = await openPicker.PickSingleFileAsync();
if (file != null)
{
// Application now has read/write access to the picked file
OutputTextBlock.Text = "Picked photo: " + file.Name;
}
else
{
OutputTextBlock.Text = "Operation cancelled.";
}
// Create the picker object and set options
var openPicker = new Windows.Storage.Pickers.FileOpenPicker();
openPicker.viewMode = Windows.Storage.Pickers.PickerViewMode.thumbnail;
openPicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.picturesLibrary;
// Users expect to have a filtered view of their folders depending on the scenario.
// For example, when choosing a documents folder, restrict the filetypes to documents for your application.
openPicker.fileTypeFilter.replaceAll([".png", ".jpg", ".jpeg"]);
// Open the picker for the user to pick a file
openPicker.pickSingleFileAsync().then(function (file) {
if (file) {
// Application now has read/write access to the picked file
WinJS.log && WinJS.log("Picked photo: " + file.name, "sample", "status");
} else {
// The picker was dismissed with no selected file
WinJS.log && WinJS.log("Operation cancelled.", "sample", "status");
}
});
internal bool EnsureUnsnapped()
{
// FilePicker APIs will not work if the application is in a snapped state.
// If an app wants to show a FilePicker while snapped, it must attempt to unsnap first
bool unsnapped = ((ApplicationView.Value != ApplicationViewState.Snapped) || ApplicationView.TryUnsnap());
if (!unsnapped)
{
NotifyUser("Cannot unsnap the sample.", NotifyType.StatusMessage);
}
return unsnapped;
}
Catatan
Anda harus selalu memastikan bahwa aplikasi Anda tidak diposisikan (atau dapat dilepas) dan mengatur properti pemilih file terlepas dari apakah pengguna memilih satu file atau beberapa file.
IReadOnlyList<StorageFile> files = await openPicker.PickMultipleFilesAsync();
if (files.Count > 0)
{
StringBuilder output = new StringBuilder("Picked files:\n");
// Application now has read/write access to the picked file(s)
foreach (StorageFile file in files)
{
output.Append(file.Name + "\n");
}
OutputTextBlock.Text = output.ToString();
}
else
{
OutputTextBlock.Text = "Operation cancelled.";
}
openPicker.pickMultipleFilesAsync().then(function (files) {
if (files.size > 0) {
// Application now has read/write access to the picked file(s)
var outputString = "Picked files:\n";
for (var i = 0; i < files.size; i++) {
outputString = outputString + files[i].name + "\n";
}
WinJS.log && WinJS.log(outputString, "sample", "status");
} else {
// The picker was dismissed with no selected file
WinJS.log && WinJS.log("Operation cancelled.", "sample", "status");
}
});
Keterangan
Untuk mulai mengakses pemilih file dan folder, lihat Mulai Cepat: Mengakses file dengan Pemilih File.
Untuk informasi tentang cara menggunakan API ini di luar aplikasi UWP, lihat Memanggil API interop dari aplikasi .NET.
Riwayat versi
Versi Windows | Versi SDK | Nilai ditambahkan |
---|---|---|
1903 | 18362 | CreateForUser |
1903 | 18362 | Pengguna |
Konstruktor
FileOpenPicker() |
Membuat instans baru FileOpenPicker. Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow. |
Properti
CommitButtonText |
Mendapatkan atau mengatur teks label tombol penerapan pemilih terbuka file. |
ContinuationData |
Mendapatkan sekumpulan nilai yang akan diisi oleh aplikasi sebelum operasi PickSingleFileAndContinue atau PickMultipleFilesAndContinue yang menonaktifkan aplikasi untuk memberikan konteks saat aplikasi diaktifkan. (aplikasi Windows Phone 8.x) |
FileTypeFilter |
Mendapatkan kumpulan jenis file yang ditampilkan pemilih buka file. |
SettingsIdentifier |
Mendapatkan atau mengatur pengidentifikasi pengaturan yang terkait dengan status pemilih buka file. |
SuggestedStartLocation |
Mendapatkan atau mengatur lokasi awal tempat pemilih buka file mencari file untuk disajikan kepada pengguna. |
User |
Mendapatkan info tentang pengguna tempat FileOpenPicker dibuat. Gunakan properti ini untuk aplikasi multi-pengguna. |
ViewMode |
Mendapatkan atau mengatur mode tampilan yang digunakan pemilih buka file untuk menampilkan item. |
Metode
CreateForUser(User) |
Membuat FileOpenPicker yang dilingkup ke direktori pribadi pengguna yang ditentukan. Gunakan metode ini untuk aplikasi multi-pengguna. |
PickMultipleFilesAndContinue() |
Usang pada Windows 10; gunakan PickSingleFolderAsync sebagai gantinya. Menampilkan pemilih file sehingga pengguna dapat memilih beberapa file, menonaktifkan dan aplikasi dan mengaktifkannya kembali saat operasi selesai. (aplikasi Windows Phone 8.x) |
PickMultipleFilesAsync() |
Menampilkan pemilih file sehingga pengguna dapat memilih beberapa file. (Aplikasi UWP) |
PickSingleFileAndContinue() |
Menampilkan pemilih file sehingga pengguna dapat memilih satu file, berpotensi menonaktifkan aplikasi dan mengaktifkannya kembali saat operasi selesai. (aplikasi Windows Phone 8.x) |
PickSingleFileAsync() |
Memperlihatkan pemilih file sehingga pengguna dapat memilih satu file. |
PickSingleFileAsync(String) |
Memperlihatkan pemilih file sehingga pengguna dapat memilih satu file. |
ResumePickSingleFileAsync() |
Melanjutkan operasi pemilihan untuk mengambil file yang dipilih pengguna jika pengguna menavigasi jauh dari aplikasi setelah operasi pemilih selesai dan aplikasi ditangguhkan. |