DataRequest Classe

Définition

Espace de noms:

Windows.ApplicationModel.DataTransfer

Permet à votre application de fournir le contenu que l’utilisateur souhaite partager ou spécifier un message, si une erreur se produit.

public ref class DataRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataRequest

Public NotInheritable Class DataRequest

Héritage

Object Platform::Object IInspectable DataRequest

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Le code suivant montre comment utiliser l’objet DataRequest 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

Votre application reçoit un objet DataRequest lorsqu’un événement datarequested se produit. Avec cet objet, votre application peut fournir des données à une application cible à l’aide d’un objet DataPackage , utiliser un objet de report pour appeler une fonction ou informer l’application cible qu’une erreur s’est produite.

Propriétés

Data	Définit ou obtient un objet DataPackage qui contient le contenu qu’un utilisateur souhaite partager.
Deadline	Obtient l’échéance pour terminer une opération de rendu différée. Si l’exécution dépasse cette échéance, les résultats du rendu différé sont ignorés.

Méthodes

FailWithDisplayText(String)	Annule l’opération de partage et fournit une chaîne d’erreur à afficher à l’utilisateur.
GetDeferral()	Prend en charge les opérations de partage asynchrones en créant et en retournant un objet DataRequestDeferral .