DataRequest.GetDeferral Methode

Definition

Namespace:

Windows.ApplicationModel.DataTransfer

Unterstützt asynchrone Freigabevorgänge, indem ein DataRequestDeferral-Objekt erstellt und zurückgegeben wird.

public:
 virtual DataRequestDeferral ^ GetDeferral() = GetDeferral;

DataRequestDeferral GetDeferral();

public DataRequestDeferral GetDeferral();

function getDeferral()

Public Function GetDeferral () As DataRequestDeferral

Gibt zurück

DataRequestDeferral

Ein Objekt, mit dem Sie Inhalte asynchron freigeben oder senden können.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie mithilfe der GetDeferral-Methode ein DataRequestDeferral-Objekt abrufen.

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();
}

Hinweise

Mit der GetDeferral-Methode kann Ihre App während eines Freigabevorgangs eine Funktion aufrufen, sodass Ihre App das DataPackage-Objekt für die Ziel-App asynchron generieren kann.

Verwenden Sie diese Methode, wenn Sie einen asynchronen Funktionsaufruf verwenden möchten, um das DataPackage während eines Freigabevorgangs zu generieren. Diese Funktion muss ein DataPackage-Objekt innerhalb von 200 ms zurückgeben, um ein Timeout des Vorgangs zu verhindern. Wenn Ihre App Inhalte freigegeben, die mehr Zeit zum Packen benötigen, z. B. eine Sammlung von Dateien oder Fotos, verwenden Sie diese Methode nicht. Verwenden Sie stattdessen die SetDataProvider-Methode , um einem DataPackage einen Delegaten zuzuweisen und dieses DataPackage an die Ziel-App zurückzugeben.