DataRequest class

Lets your app supply the content the user wants to share or specify a message, if an error occurs.

Syntax

/* For information about creating or accessing this object, see Remarks. */

Attributes

MarshalingBehaviorAttribute(Agile)

MuseAttribute()

VersionAttribute(NTDDI_WIN8)

Members

The DataRequest class has these types of members:

• Methods
• Properties

Methods

The DataRequest class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

Properties

The DataRequest class has these properties.

Remarks

Your app receives a DataRequest object when a datarequested event occurs. With this object, your app can supply data to a target app by using a DataPackage object, use a deferral object to call a function, or inform the target app that an error occurred.

Examples

The following code shows how to use the DataRequest object as part of setting the data on a DataPackage to share with another app.

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!");
}

Requirements

Build date: 2/25/2013