TargetFileRequestDeferral 클래스

정의

네임스페이스:

Windows.Storage.Pickers.Provider

앱이 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

상속

Object Platform::Object IInspectable TargetFileRequestDeferral

특성

ContractVersionAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

파일 선택기 샘플에서는 지연을 가져오는 방법을 포함하여 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);

이 예제 e 에서는 TargetFileRequestedEventArgs 개체를 포함합니다.

설명

앱이 파일 저장 선택기 계약에 참여하고 TargetFileRequested 이벤트가 발생하는 경우 앱은 사용자가 저장하려는 파일을 나타내는 새 StorageFile 을 만들어야 합니다. 만든 StorageFile 의 이름은 FileName 속성에 지정된 파일의 이름과 일치해야 합니다. 사용자가 만든 StorageFile 은 호출 앱이 파일에 콘텐츠를 쓸 수 있도록 파일 선택기(호출 앱)를 호출한 앱으로 반환됩니다. targetFileRequestedEventArgs에서 이 이벤트에 응답하는 방법에 대해 자세히 알아봅니다.

저장 위치의 공급자인 앱은 targetFileRequestDeferral.complete를 호출하여 TargetFileRequested 이벤트에 대한 비동기 응답을 완료했음을 알릴 수 있습니다. TargetFileRequestedEventArgs에서 TargetFileRequested 이벤트에 비동기적으로 응답하는 방법에 대해 자세히 알아봅니다.

메서드

Complete()

저장 위치를 제공하는 앱이 TargetFileRequested 이벤트에 대한 응답을 완료했음을 나타냅니다.