TargetFileRequest 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.
Memungkinkan aplikasi yang menyediakan lokasi penyimpanan menentukan StorageFile yang mewakili file untuk disimpan dan mendapatkan penundaan sehingga aplikasi dapat merespons secara asinkron ke peristiwa TargetFileRequested .
public ref class TargetFileRequest sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class TargetFileRequest final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class TargetFileRequest
Public NotInheritable Class TargetFileRequest
- Warisan
- Atribut
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 penanganan aktivitas TargetFileRequested, termasuk cara menggunakan properti Permintaan untuk mendapatkan TargetFileRequest.
// 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
Jika aplikasi Anda berpartisipasi dalam kontrak Pemilih Simpan File dan peristiwa Targetfilerequested diaktifkan, aplikasi Anda harus membuat StorageFile baru yang mewakili file yang ingin disimpan pengguna. Nama StorageFile yang Anda buat harus cocok dengan nama file yang ditentukan oleh properti FileName . StorageFile yang Anda buat dikembalikan ke aplikasi yang disebut pemilih file (aplikasi panggilan) sehingga aplikasi panggilan dapat menulis konten ke file. Pelajari selengkapnya tentang menanggapi peristiwa ini di TargetFileRequestedEventArgs.
Properti
TargetFile |
Mendapatkan atau mengatur objek IStorageFile yang disediakan untuk mewakili file untuk disimpan oleh aplikasi yang menyediakan lokasi penyimpanan. |
Metode
GetDeferral() |
Mendapatkan TargetFileRequestDeferral yang dapat digunakan aplikasi yang menyediakan lokasi penyimpanan untuk merespons secara asinkron ke peristiwa TargetFileRequested . |