StorageFile.CreateStreamedFileAsync Metodo

Definizione

Spazio dei nomi:

Windows.Storage

Crea un oggetto StorageFile per rappresentare il flusso di dati specificato. Questo metodo consente all'app di produrre i dati su richiesta specificando una funzione da richiamare quando si accede per la prima volta a StorageFile che rappresenta il flusso.

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)

Parametri

displayNameWithExtension

String

Platform::String

winrt::hstring

Nome descrittivo di StorageFile da creare, inclusa un'estensione del tipo di file.

dataRequested

StreamedFileDataRequestedHandler

Funzione che deve essere richiamata quando si accede per la prima volta a StorageFile restituito. Questa funzione deve produrre il flusso di dati rappresentato da StorageFile restituito e consente all'app di produrre dati su richiesta anziché scrivere il contenuto del file in fase di creazione.

thumbnail

IRandomAccessStreamReference

Immagine di anteprima per StorageFile da creare.

Per un'anteprima di alta qualità, un bordo di questa anteprima deve essere di almeno 1024 pixel.

Restituisce

IAsyncOperation<StorageFile>

Al termine di questo metodo, restituisce un oggetto StorageFile che rappresenta il nuovo flusso di dati.

Attributi

RemoteAsyncAttribute

Commenti

Sia questo metodo che CreateStreamedFileFromUriAsync possono essere usati per creare un oggetto StorageFile che può essere passato ad altri metodi o passato a un'altra app tramite contratti dell'app.

Questi metodi consentono di rinviare le operazioni dispendiose per produrre i dati fino a quando non sono necessari (quando viene eseguito per la prima volta l'accesso). In questo modo si evitano ritardi non necessari durante l'interazione dell'utente durante la produzione dei dati.