TargetFileRequestDeferral Kelas

Definisi

Ruang nama:

Windows.Storage.Pickers.Provider

Digunakan oleh aplikasi yang menyediakan lokasi penyimpanan untuk menunjukkan secara asinkron bahwa aplikasi selesai merespons peristiwa TargetFileRequested .

public ref class TargetFileRequestDeferral sealed

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

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

Public NotInheritable Class TargetFileRequestDeferral

Warisan

Object Platform::Object IInspectable TargetFileRequestDeferral

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

// 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 File Save Picker 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 merespons peristiwa ini di targetFileRequestedEventArgs.

Aplikasi Anda, sebagai penyedia lokasi penyimpanan, dapat memberi sinyal bahwa aplikasi tersebut telah menyelesaikan respons asinkronnya terhadap peristiwa TargetFileRequested dengan memanggil targetFileRequestDeferral.complete. Pelajari selengkapnya tentang merespons secara asinkron ke peristiwa TargetFileRequested di TargetFileRequestedEventArgs.

Metode

Complete()

Menandakan bahwa aplikasi yang menyediakan lokasi penyimpanan selesai merespons peristiwa TargetFileRequested .