DataRequest 類別

DataRequest Class

發生錯誤時,讓您的應用程式提供使用者想要共用的內容或指定某訊息。

語法


/* 如需建立或存取這個物件的詳細資訊,請參閱<備註>。 */

屬性

[MarshalingBehavior(Agile)]
[Muse()]
[Version(0x06020000)]

成員

DataRequest類別 具有下列類型的成員:

方法

The DataRequest 類別 擁有這些方法。 使用 C#、Visual Basic 和 C++,它也會繼承方法自Object 類別.

方法描述
FailWithDisplayText Cancels the sharing operation and supplies an error string to display to the user.
GetDeferral Supports asynchronous sharing operations by creating and returning a DataRequestDeferral object.

 

屬性

DataRequest類別 擁有這些屬性。

屬性存取類型描述

Data

讀取/寫入Sets or gets a DataPackage object that contains the content a user wants to share.

Deadline

唯讀Gets the deadline for finishing a delayed rendering operation. If execution goes beyond that deadline, the results of delayed rendering are ignored.

 

備註

您的應用程式會在 datarequested 事件發生時接收 DataRequest 物件。有了這個物件,您的應用程式就可以利用 DataPackage 物件提供資料給目標應用程式、使用延遲物件呼叫函式,或是告知目標應用程式發生錯誤。

範例

下列程式碼示範如何使用 DataRequest 物件,當做在 DataPackage 設定資料用來與另一個應用程式共用的一部分。


function registerForShare() {
    var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
    dataTransferManager.addEventListener("datarequested", shareTextHandler);
}

function shareTextHandler(e) {
    var request = e.request;
    request.data.properties.title = "Share Text Example";
    request.data.properties.description = "A demonstration that shows how to share.";
    request.data.setText("Hello World!");
}


需求

支援的最小用戶端

Windows 8 [僅限 Windows 市集應用程式]

支援的最小伺服器

Windows Server 2012 [僅限 Windows 市集應用程式]

支援的最小電話

Windows Phone 8

命名空間

Windows.ApplicationModel.DataTransfer
Windows::ApplicationModel::DataTransfer [C++]

Metadata

Windows.winmd

 

 

顯示:
© 2017 Microsoft