TargetFileRequest 클래스

정의

저장 위치를 제공하는 앱이 저장 및 지연을 가져올 파일을 나타내는 StorageFile 을 지정하여 앱이 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
상속
Object Platform::Object IInspectable TargetFileRequest
특성

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에서 도입되었습니다.)

예제

파일 선택기 샘플에서는 Request 속성을 사용하여 TargetFileRequest를 가져오는 방법을 포함하여 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에서 이 이벤트에 응답하는 방법에 대해 자세히 알아봅니다.

속성

TargetFile

저장 위치를 제공하는 앱에서 저장할 파일을 나타내기 위해 제공되는 IStorageFile 개체를 가져오거나 설정합니다.

메서드

GetDeferral()

저장 위치를 제공하는 앱이 TargetFileRequested 이벤트에 비동기적으로 응답하는 데 사용할 수 있는 TargetFileRequestDeferral 을 가져옵니다.

적용 대상