DataRequest.Data Propriété

Définition

Espace de noms:

Windows.ApplicationModel.DataTransfer

Définit ou obtient un objet DataPackage qui contient le contenu qu’un utilisateur souhaite partager.

public:
 property DataPackage ^ Data { DataPackage ^ get(); void set(DataPackage ^ value); };

DataPackage Data();

void Data(DataPackage value);

public DataPackage Data { get; set; }

var dataPackage = dataRequest.data;
dataRequest.data = dataPackage;

Public Property Data As DataPackage

Valeur de propriété

DataPackage

Contient le contenu qu’un utilisateur souhaite partager.

Exemples

Le code suivant montre comment obtenir un objet DataPackage à partir de la propriété Data dans le cadre de la définition des données d’un DataPackage à partager avec une autre application.

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

Remarques

La propriété Data permet à votre application de fournir des données à une application cible. Votre application doit fournir ces données à l’aide d’un objet DataPackage .

Utilisez cette propriété lorsque votre application a le contenu immédiatement disponible que l’utilisateur souhaite partager. Si vous devez appeler une fonction pour générer le DataPackage, utilisez la méthode GetDeferral .

Lorsque votre application ne peut pas fournir un objet DataPackage , utilisez la méthode FailWithDisplayText pour annuler le partage et fournir un message que l’application cible peut afficher à l’utilisateur.