StorageFile.CreateStreamedFileAsync 메서드

정의

지정된 데이터 스트림을 나타내는 StorageFile 을 만듭니다. 이 메서드를 사용하면 스트림을 나타내는 StorageFile 에 처음 액세스할 때 호출할 함수를 지정하여 앱에서 요청 시 데이터를 생성할 수 있습니다.

public:
 static IAsyncOperation<StorageFile ^> ^ CreateStreamedFileAsync(Platform::String ^ displayNameWithExtension, StreamedFileDataRequestedHandler ^ dataRequested, IRandomAccessStreamReference ^ thumbnail);
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> CreateStreamedFileAsync(winrt::hstring const& displayNameWithExtension, StreamedFileDataRequestedHandler const& dataRequested, IRandomAccessStreamReference const& thumbnail);
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateStreamedFileAsync(string displayNameWithExtension, StreamedFileDataRequestedHandler dataRequested, IRandomAccessStreamReference thumbnail);
function createStreamedFileAsync(displayNameWithExtension, dataRequested, thumbnail)
Public Shared Function CreateStreamedFileAsync (displayNameWithExtension As String, dataRequested As StreamedFileDataRequestedHandler, thumbnail As IRandomAccessStreamReference) As IAsyncOperation(Of StorageFile)

매개 변수

displayNameWithExtension
String

Platform::String

winrt::hstring

파일 형식 확장명을 포함하여 만들 StorageFile 의 사용자에게 친숙한 이름입니다.

dataRequested
StreamedFileDataRequestedHandler

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

thumbnail
IRandomAccessStreamReference

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

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

반환

이 메서드가 완료되면 새 데이터 스트림을 나타내는 StorageFile 개체를 반환합니다.

특성

설명

이 메서드와 CreateStreamedFileFromUriAsync 를 모두 사용하여 다른 메서드로 전달하거나 앱 계약을 통해 다른 앱에 전달할 수 있는 StorageFile 을 만들 수 있습니다.

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

적용 대상