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 方法來取消共用，並提供目標應用程式可以向使用者顯示的訊息。