DataRequest.GetDeferral Metodo

Definizione

Supporta operazioni di condivisione asincrone creando e restituendo un oggetto DataRequestDeferral .

public:
 virtual DataRequestDeferral ^ GetDeferral() = GetDeferral;
DataRequestDeferral GetDeferral();
public DataRequestDeferral GetDeferral();
function getDeferral()
Public Function GetDeferral () As DataRequestDeferral

Restituisce

Oggetto che consente di condividere o inviare contenuto in modo asincrono.

Esempio

Nell'esempio seguente viene illustrato come ottenere un oggetto DataRequestDeferral usando il metodo GetDeferral .

void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequestDeferral deferral = e.Request.GetDeferral();
    e.Request.Data.Properties.Title = "Hello World!";
    e.Request.Data.Properties.Description = "This example shows how to share files and images.";
    if (this.dataPackageThumbnail != null)
    {
        e.Request.Data.Properties.Thumbnail = this.dataPackageThumbnail;
    }
    e.Request.Data.SetBitmap(imageStreamRef);
    deferral.Complete();
}

Commenti

Il metodo GetDeferral consente all'app di chiamare una funzione durante un'operazione di condivisione, in modo che l'app possa generare in modo asincrono l'oggetto DataPackage per l'app di destinazione.

Utilizzare questo metodo quando si vuole usare una chiamata di funzione asincrona per generare il DataPackage durante un'operazione di condivisione. Questa funzione deve restituire un oggetto DataPackage entro 200 ms per impedire il timeout dell'operazione. Se l'app condivide il contenuto che richiede più tempo per creare il pacchetto, ad esempio una raccolta di file o foto, non usare questo metodo. Usare invece il metodo SetDataProvider per assegnare un delegato a un DataPackage e restituire tale DataPackage all'app di destinazione.

Si applica a