DataRequest.Data 属性

定义

命名空间:

Windows.ApplicationModel.DataTransfer

设置或获取包含用户想要共享的内容的 DataPackage 对象。

public:
 property DataPackage ^ Data { DataPackage ^ get(); void set(DataPackage ^ value); };

DataPackage Data();

void Data(DataPackage value);

public DataPackage Data { get; set; }

var dataPackage = dataRequest.data;
dataRequest.data = dataPackage;

Public Property Data As DataPackage

属性值

DataPackage

包含用户想要共享的内容。

示例

以下代码演示如何从 Data 属性获取 DataPackage 对象，作为将 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!");
}

注解

Data 属性使应用能够向目标应用提供数据。 应用必须使用 DataPackage 对象提供此数据。

当应用具有用户想要共享的内容立即可用时，请使用此属性。 如果需要调用函数来生成 DataPackage，请使用 GetDeferral 方法。

当应用无法提供 DataPackage 对象时，请使用 FailWithDisplayText 方法取消共享，并提供目标应用可以向用户显示的消息。