TargetFileRequest 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

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: Object Platform::Object IInspectable TargetFileRequest

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

Berlaku untuk

Bagikan melalui