TargetFileRequestedEventArgs 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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 TargetFileRequestedEventArgsPublic NotInheritable Class TargetFileRequestedEventArgs- 상속
- 특성
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 이벤트가 발생하는 경우 앱은 다음 단계에 따라 응답해야 합니다.
- TargetFileRequestedEventArgs.request 속성을 사용하여 TargetFileRequest를 가져옵니다.
- 저장할 파일을 나타내는 StorageFile 을 만들거나 검색합니다. 이 StorageFile 은 저장하기 위해 파일 선택기를 호출한 앱으로 반환되고 호출하는 앱에서 파일에 콘텐츠를 쓰는 데 사용됩니다.
파일을 나타내는 개체의 파일 이름 및 확장명은 사용자가 지정한 파일 이름 및 확장명과 일치해야 하며 FileName을 통해 액세스할 수 있어야 합니다. 그렇지 않으면 파일을 저장하려는 시도가 실패합니다. 시도가 실패하면 사용자가 파일을 다시 저장하려고 시도할 수 있습니다.
저장 위치의 공급자인 앱에서 저장할 파일의 개체를 제공할 수 없는 경우 TargetFileRequest.TargetFile 을 null로 설정합니다.
- TargetFileRequest.TargetFile을 StorageFile 개체로 설정합니다.
비동기적으로 응답
저장 위치를 제공하는 앱이 이벤트 처리기에서 반환되기 전에 TargetFileRequested 이벤트에 대한 응답을 완료할 수 없는 경우(예: 앱이 비동기 메서드를 호출하는 경우) 지연하여 응답을 비동기적으로 완료할 수 있습니다.
저장 위치의 공급자인 앱은 다음 단계에 따라 이벤트에 비동기적으로 응답하기 위해 연기할 수 있습니다.
- TargetFileRequestedEventArgs.request 속성을 사용하여 TargetFileRequest를 가져옵니다.
- TargetFileRequest.GetDeferral을 호출하여 TargetFileRequestDeferral 개체를 가져옵니다.
- TargetFileRequested 이벤트에 응답하는 데 필요한 단계를 수행합니다(이전 섹션에서 설명).
- TargetFileRequestDeferral.Complete를 호출하여 앱이 TargetFileRequested 이벤트에 대한 응답을 완료했음을 나타냅니다.
속성
| Request |
TargetFileRequested 이벤트에 응답하는 데 사용되는 TargetFileRequest 개체를 가져옵니다. |