FileUpdateRequest 클래스

정의

네임스페이스:

Windows.Storage.Provider

앱이 요청을 완료할 수 있도록 요청된 파일 업데이트에 대한 정보를 제공합니다.

public ref class FileUpdateRequest sealed

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

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

Public NotInheritable Class FileUpdateRequest

상속

Object Platform::Object IInspectable FileUpdateRequest

특성

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

예제

파일 선택기 계약 샘플에서는 Request를 사용하여 FileUpdateRequest를 가져오는 방법을 포함하여 FileUpdateRequested 이벤트에 응답하는 방법을 보여 줍니다.

// Event handler
void CachedFileUpdaterUI_FileUpdateRequested(CachedFileUpdaterUI sender, FileUpdateRequestedEventArgs args)
{
    fileUpdateRequest = args.Request;
    fileUpdateRequestDeferral = fileUpdateRequest.GetDeferral();
    switch (cachedFileUpdaterUI.UIStatus)
    {
        case UIStatus.Hidden:
            fileUpdateRequest.Status = FileUpdateStatus.UserInputNeeded;
            fileUpdateRequestDeferral.Complete();
            break;
        case UIStatus.Visible:
            break;
        case UIStatus.Unavailable:
            fileUpdateRequest.Status = FileUpdateStatus.Failed;
            fileUpdateRequestDeferral.Complete();
            break;
    }
}

// Register for the event
cachedFileUpdaterUI.FileUpdateRequested += CachedFileUpdaterUI_FileUpdateRequested;

args 에는 FileUpdateRequestedEventArgs 개체가 포함되어 있습니다.

설명

앱이 캐시된 파일 업데이트 프로그램 계약에 참여하는 경우 이 클래스를 사용하여 Windows에서 FileUpdateRequested 이벤트를 발생시킬 때 응답하여 파일 업데이트를 요청합니다. FileUpdateRequestedEventArgs를 사용하여 이벤트 처리기에서 이 클래스에 액세스할 수 있습니다. 요청 속성입니다. FileUpdateRequested 이벤트에 대한 응답의 일부로 이 클래스의 Status 속성을 설정하여 업데이트의 상태 나타내야 합니다.

FileUpdateRequested 및FileUpdateRequestedEventArgs에서 업데이트 요청에 응답하는 방법에 대해 자세히 알아봅니다.

FileUpdateRequested 이벤트 처리기에서 반환하기 전에 앱이 업데이트를 완료할 수 없는 경우 GetDeferral 속성을 사용하여 업데이트를 비동기적으로 완료할 수 있습니다.

속성

ContentId	파일의 로컬 버전을 해당 원격 버전과 연결하는 데 사용되는 고유 식별자를 가져옵니다.
File	업데이트할 파일의 로컬로 캐시된 복사본을 나타내는 StorageFile 개체를 가져옵니다.
Status	업데이트의 상태 가져오거나 설정합니다. 이 속성은 FileUpdateRequested 이벤트에 대한 응답으로 설정됩니다.
UserInputNeededMessage	FileUpdateRequest를 완료하는 데 사용자 입력이 필요하다는 메시지를 가져오거나 설정합니다.

메서드

GetDeferral()	업데이트를 비동기적으로 완료하는 데 사용되는 개체를 가져옵니다.
UpdateLocalFile(IStorageFile)	원격 파일을 나타내는 새 버전의 로컬 파일을 제공합니다.