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 物件，以支援非同步共用作業。