FileOpenPicker Kelas

Definisi

Ruang nama:

Windows.Storage.Pickers

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

Object Platform::Object IInspectable FileOpenPicker

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Lihat juga

• Sampel pemilih file
• Mulai cepat: Mengakses file dengan Pemilih File
• Sampel blob
• Menampilkan objek UI WinRT yang bergantung pada CoreWindow