다음을 통해 공유

TargetFileRequestedEventArgs 클래스

  • 참조

정의

네임스페이스:
Windows.Storage.Pickers.Provider
편집

TargetFileRequested 이벤트에 대한 정보를 제공합니다.

public ref class TargetFileRequestedEventArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class TargetFileRequestedEventArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class TargetFileRequestedEventArgs
Public NotInheritable Class TargetFileRequestedEventArgs
상속
Object Platform::Object IInspectable TargetFileRequestedEventArgs
특성
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 이벤트에 대한 이벤트 처리기에 전달됩니다.

TargetFileRequested 이벤트에 응답

앱이 파일 저장 선택기 계약에 참여하고 TargetFileRequested 이벤트가 발생하는 경우 앱은 다음 단계에 따라 응답해야 합니다.

  1. TargetFileRequestedEventArgs.request 속성을 사용하여 TargetFileRequest를 가져옵니다.
  2. 저장할 파일을 나타내는 StorageFile 을 만들거나 검색합니다. 이 StorageFile 은 저장하기 위해 파일 선택기를 호출한 앱으로 반환되고 호출하는 앱에서 파일에 콘텐츠를 쓰는 데 사용됩니다.

파일을 나타내는 개체의 파일 이름 및 확장명은 사용자가 지정한 파일 이름 및 확장명과 일치해야 하며 FileName을 통해 액세스할 수 있어야 합니다. 그렇지 않으면 파일을 저장하려는 시도가 실패합니다. 시도가 실패하면 사용자가 파일을 다시 저장하려고 시도할 수 있습니다.

저장 위치의 공급자인 앱에서 저장할 파일의 개체를 제공할 수 없는 경우 TargetFileRequest.TargetFile 을 null로 설정합니다.

  1. TargetFileRequest.TargetFile을 StorageFile 개체로 설정합니다.

비동기적으로 응답

저장 위치를 제공하는 앱이 이벤트 처리기에서 반환되기 전에 TargetFileRequested 이벤트에 대한 응답을 완료할 수 없는 경우(예: 앱이 비동기 메서드를 호출하는 경우) 지연하여 응답을 비동기적으로 완료할 수 있습니다.

저장 위치의 공급자인 앱은 다음 단계에 따라 이벤트에 비동기적으로 응답하기 위해 연기할 수 있습니다.

  1. TargetFileRequestedEventArgs.request 속성을 사용하여 TargetFileRequest를 가져옵니다.
  2. TargetFileRequest.GetDeferral을 호출하여 TargetFileRequestDeferral 개체를 가져옵니다.
  3. TargetFileRequested 이벤트에 응답하는 데 필요한 단계를 수행합니다(이전 섹션에서 설명).
  4. TargetFileRequestDeferral.Complete를 호출하여 앱이 TargetFileRequested 이벤트에 대한 응답을 완료했음을 나타냅니다.

속성

Request

TargetFileRequested 이벤트에 응답하는 데 사용되는 TargetFileRequest 개체를 가져옵니다.

적용 대상

추가 정보