DataRequestedEventArgs DataRequestedEventArgs DataRequestedEventArgs DataRequestedEventArgs Class

Definition

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

public : sealed class DataRequestedEventArgs : IDataRequestedEventArgs
public sealed class DataRequestedEventArgs : IDataRequestedEventArgs
Public NotInheritable Class DataRequestedEventArgs Implements IDataRequestedEventArgs
// This class does not provide a public constructor.
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 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
var dataRequest = dataRequestedEventArgs.request;
Value
DataRequest DataRequest DataRequest DataRequest

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

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.