DataRequest.GetDeferral 方法

定义

命名空间:

Windows.ApplicationModel.DataTransfer

通过创建和返回 DataRequestDeferral 对象支持异步共享操作。

public:
 virtual DataRequestDeferral ^ GetDeferral() = GetDeferral;

DataRequestDeferral GetDeferral();

public DataRequestDeferral GetDeferral();

function getDeferral()

Public Function GetDeferral () As DataRequestDeferral

返回

DataRequestDeferral

允许异步共享或发送内容的 对象。

示例

以下示例演示如何使用 GetDeferral 方法获取 DataRequestDeferral 对象。

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

注解

GetDeferral 方法允许应用在共享操作期间调用函数，以便应用可以异步生成目标应用的 DataPackage 对象。

如果要在共享操作期间使用异步函数调用来生成 DataPackage ，请使用此方法。 此函数必须在 200 毫秒内返回 DataPackage 对象，以防止操作超时。如果你的应用共享的内容需要更多时间来打包，例如文件或照片集合，请不要使用此方法。 相反，使用 SetDataProvider 方法将委托分配给 DataPackage ，并将该 DataPackage 返回到目标应用。