DataRequestedEventArgs 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
struct winrt::Windows::ApplicationModel::DataTransfer::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 Request

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