DataRequest 类

定义

命名空间:

Windows.ApplicationModel.DataTransfer

允许应用提供用户想要共享的内容，或者在发生错误时指定消息。

public ref class DataRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataRequest

Public NotInheritable Class DataRequest

继承

Object Platform::Object IInspectable DataRequest

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

以下代码演示如何使用 DataRequest 对象作为 DataPackage 上的数据设置为与其他应用共享的一部分。

//To see this code in action, add a call to ShareSourceLoad to your constructor or other
//initializing function.
private void ShareSourceLoad()
{
    DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();
    dataTransferManager.DataRequested += new TypedEventHandler<DataTransferManager, DataRequestedEventArgs>(this.DataRequested);
}

private void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequest request = e.Request;
    request.Data.Properties.Title = "Share Text Example";
    request.Data.Properties.Description = "An example of how to share text.";
    request.Data.SetText("Hello World!");
}

注解

当 发生 datarequested 事件时，应用会收到 DataRequest 对象。 使用此对象，应用可以使用 DataPackage 对象向目标应用提供数据，使用延迟对象调用函数，或通知目标应用发生错误。

属性

Data	设置或获取包含用户想要共享的内容的 DataPackage 对象。
Deadline	获取完成延迟呈现操作的截止时间。 如果执行超出该截止时间，则会忽略延迟呈现的结果。

方法

FailWithDisplayText(String)	取消共享操作并提供要向用户显示的错误字符串。
GetDeferral()	通过创建和返回 DataRequestDeferral 对象支持异步共享操作。