Data​Requested​Event​Args Data​Requested​Event​Args Data​Requested​Event​Args Class

Definition

Contains information about the DataRequested event. The system fires this event when the user invokes the Share UI.

public : sealed class DataRequestedEventArgs : IDataRequestedEventArgspublic sealed class DataRequestedEventArgs : IDataRequestedEventArgsPublic NotInheritable Class DataRequestedEventArgs Implements IDataRequestedEventArgs
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Examples

//To see this code in action, add a call to ShareSouceLoad 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!");
}
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!");
}

Remarks

To share content from one app to another, a user invokes the Share UI. The most common way to do this is through the charms, although you can use the DataTransferManager class to launch the UI programmatically. When the Share UI launches, the system fires a datarequested event. The object included with this event is an instance of the DataRequestedEventArgs class.

This event has one property, request. This property contains an instance of the DataRequest class, which your app uses to supply the content the user wants to share with the target app.

Properties

Request Request Request

Enables you to get the DataRequest object and either give it data or a failure message.

public : DataRequest Request { get; }public DataRequest Request { get; }Public ReadOnly Property Request As DataRequest
Value
DataRequest DataRequest DataRequest

The object used to manage content as part of a share operation.

Attributes

Remarks

When a user invokes the Share UI to share content, the system fires a datarequested event. The request property of the event contains a DataRequest object, which lets your app supply the information the user wants to share.