TargetFileRequestedEventArgs Kelas

Referensi

Definisi

Ruang nama:: Windows.Storage.Pickers.Provider

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.

Edit

Menyediakan informasi tentang peristiwa TargetFileRequested .

public ref class TargetFileRequestedEventArgs sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class TargetFileRequestedEventArgs final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class TargetFileRequestedEventArgs

Public NotInheritable Class TargetFileRequestedEventArgs

Warisan: Object Platform::Object IInspectable TargetFileRequestedEventArgs

Atribut: ContractVersionAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Sampel Pemilih file menunjukkan cara merespons peristiwa TargetFileRequested.

// Event handler
private async void OnTargetFileRequested(FileSavePickerUI sender, TargetFileRequestedEventArgs e)
{
    // Respond to TargetFileRequested event on the background thread on which it was raised

    // Requesting a deferral allows the app to call another asynchronous method and complete the request at a later time
    var deferral = e.Request.GetDeferral();

    // Create file and assign to TargetFile property
    e.Request.TargetFile = await ApplicationData.Current.LocalFolder.CreateFileAsync(sender.FileName, CreationCollisionOption.GenerateUniqueName);

    // Complete the deferral to let the Picker know the request is finished
    deferral.Complete();
}

// Register for the event
fileSavePickerUI.TargetFileRequested += new TypedEventHandler<FileSavePickerUI, TargetFileRequestedEventArgs>(OnTargetFileRequested);

Dalam contoh, e berisi objek TargetFileRequestedEventArgs.

Keterangan

Objek ini diteruskan ke penanganan aktivitas untuk peristiwa TargetFileRequested .

Menanggapi peristiwa TargetFileRequested

Jika aplikasi Anda berpartisipasi dalam kontrak Pemilih Simpan File dan peristiwa TargetFileRequested diaktifkan, aplikasi Anda harus merespons dengan mengikuti langkah-langkah berikut:

Dapatkan TargetFileRequest menggunakan properti TargetFileRequestedEventArgs.request .
Membuat (atau mengambil) StorageFile untuk mewakili file yang akan disimpan; StorageFile ini dikembalikan ke aplikasi yang memanggil pemilih file untuk menyimpan dan digunakan oleh aplikasi panggilan untuk menulis konten ke file.

Nama file dan ekstensi objek yang mewakili file harus cocok dengan nama file dan ekstensi yang ditentukan oleh pengguna (dan dapat diakses melalui FileName) atau upaya untuk menyimpan file akan gagal. Jika upaya gagal, pengguna dapat mencoba menyimpan file lagi.

Jika aplikasi Anda (sebagai penyedia lokasi penyimpanan) tidak dapat menyediakan objek untuk disimpan file, atur TargetFileRequest.TargetFile ke null.

Atur TargetFileRequest.TargetFile ke objek StorageFile .

Merespons secara asinkron

Jika aplikasi Anda, yang menyediakan lokasi penyimpanan, tidak dapat selesai merespons peristiwa TargetFileRequested sebelum kembali dari penanganan aktivitasnya (misalnya, jika aplikasi Anda memanggil metode asinkron), Anda dapat menyelesaikan respons secara asinkron dengan menangguhkan.

Aplikasi Anda, sebagai penyedia lokasi penyimpanan, dapat menangguhkan untuk merespons peristiwa secara asinkron dengan mengikuti langkah-langkah berikut:

Dapatkan TargetFileRequest menggunakan properti TargetFileRequestedEventArgs.request .
Panggil TargetFileRequest.GetDeferral untuk mendapatkan objek TargetFileRequestDeferral .
Lakukan langkah-langkah yang diperlukan untuk merespons peristiwa TargetFileRequested (dijelaskan di bagian sebelumnya).
Panggil TargetFileRequestDeferral.Complete untuk memberi sinyal bahwa aplikasi Anda telah selesai merespons peristiwa TargetFileRequested .

Properti

Request

Mendapatkan objek TargetFileRequest yang digunakan untuk merespons peristiwa TargetFileRequested .

Berlaku untuk

Bagikan melalui