다음을 통해 공유


StorageFile.ReplaceWithStreamedFileAsync 메서드

정의

지정된 IStorageFile 개체에서 참조하는 파일의 내용을 새 데이터 스트림으로 바꿉니다. 이 메서드를 사용하면 스트림을 나타내는 StorageFile 에 처음 액세스할 때 호출할 함수를 지정하여 앱에서 요청 시 데이터를 생성할 수 있습니다.

public:
 static IAsyncOperation<StorageFile ^> ^ ReplaceWithStreamedFileAsync(IStorageFile ^ fileToReplace, StreamedFileDataRequestedHandler ^ dataRequested, IRandomAccessStreamReference ^ thumbnail);
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> ReplaceWithStreamedFileAsync(IStorageFile const& fileToReplace, StreamedFileDataRequestedHandler const& dataRequested, IRandomAccessStreamReference const& thumbnail);
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> ReplaceWithStreamedFileAsync(IStorageFile fileToReplace, StreamedFileDataRequestedHandler dataRequested, IRandomAccessStreamReference thumbnail);
function replaceWithStreamedFileAsync(fileToReplace, dataRequested, thumbnail)
Public Shared Function ReplaceWithStreamedFileAsync (fileToReplace As IStorageFile, dataRequested As StreamedFileDataRequestedHandler, thumbnail As IRandomAccessStreamReference) As IAsyncOperation(Of StorageFile)

매개 변수

fileToReplace
IStorageFile

새 데이터 스트림을 작성해야 하는 파일( IStorageFile 형식)입니다.

dataRequested
StreamedFileDataRequestedHandler

반환되는 StorageFile 에 처음 액세스할 때 호출해야 하는 함수입니다. 이 함수는 반환된 StorageFile 이 나타내는 데이터 스트림을 생성하고 생성 시 파일 내용을 작성하는 대신 앱이 주문형 데이터를 생성할 수 있도록 해야 합니다.

thumbnail
IRandomAccessStreamReference

만들 StorageFile 의 썸네일 이미지입니다.

고품질 썸네일의 경우 이 썸네일의 한쪽 가장자리는 1024픽셀 이상이어야 합니다.

반환

이 메서드가 완료되면 새 데이터 스트림을 나타내는 StorageFile 개체를 반환합니다. 그 후 이 StorageFile 개체를 사용하여 바꿀 파일( IStorageFile 형식) 대신 파일 콘텐츠에 액세스해야 합니다.

특성

설명

이 메서드를 사용하면 해당 데이터가 필요할 때까지(처음 액세스할 때) 데이터를 생성하기 위해 비용이 많이 드는 작업을 연기할 수 있습니다. 이렇게 하면 데이터가 생성되는 동안 사용자 상호 작용에 불필요한 지연이 발생하지 않습니다.

적용 대상