DataTransferManager Classe

Définition

Espace de noms:

Windows.ApplicationModel.DataTransfer

Initie par programme un échange de contenu avec d’autres applications.

public ref class DataTransferManager sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DataTransferManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DataTransferManager

Public NotInheritable Class DataTransferManager

Héritage

Object Platform::Object IInspectable DataTransferManager

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Cet exemple montre une méthode classique d’utilisation de l’objet DataTransferManager .

function setupShare() {
    var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();
    dataTransferManager.addEventListener("datarequested", function (e) {
        var request = e.request;
        request.data.properties.title = "Share Demonstration";
        request.data.setText("Hello World!");
    });
}

Remarques

La classe DataTransferManager est une classe statique que vous utilisez pour lancer des opérations de partage. Pour utiliser la classe, appelez d’abord la méthode GetForCurrentView . Cette méthode retourne l’objet DataTransferManager spécifique à la fenêtre active. Ensuite, vous devez ajouter un écouteur d’événements pour l’événement datarequested à l’objet. Cet événement est déclenché lorsqu’une opération de partage démarre, généralement lorsque l’utilisateur appuie sur l’icône Partager, bien qu’il soit également déclenché si votre application démarre une opération de partage par programmation.

La classe DataTransferManager inclut une méthode ShowShareUI , que vous pouvez utiliser pour démarrer par programmation une opération de partage.

La classe DataTransferManager a également un événement TargetApplicationChosen . Utilisez cet événement lorsque vous souhaitez capturer les applications sélectionnées par un utilisateur lors du partage de contenu à partir de votre application.

Notes

Cette classe n’est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d’informations, consultez Threading and Marshaling (C++/CX) et Using Windows Runtime objects in a multithreaded environment (.NET).

Windows Phone 8

Cette API est prise en charge uniquement dans les applications natives.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1607	14393	IsSupported
1703	15063	ShareProvidersRequested
1709	16299	ShowShareUI(ShareUIOptions)

Méthodes

GetForCurrentView()	Renvoie l’objet DataTransferManager associé à la fenêtre active.
IsSupported()	Retourne true si l’appareil prend en charge le partage, false sinon.
ShowShareUI()	Initie par programmation l’interface utilisateur pour le partage de contenu avec une autre application. Cette API est destinée aux applications plateforme Windows universelle (UWP). L’autre API à utiliser pour une application de bureau est décrite dans Afficher les objets d’interface utilisateur WinRT qui dépendent de CoreWindow.
ShowShareUI(ShareUIOptions)	Initie par programmation l’interface utilisateur pour le partage de contenu avec une autre application. Cette API est destinée aux applications plateforme Windows universelle (UWP). L’autre API à utiliser pour une application de bureau est décrite dans Afficher les objets d’interface utilisateur WinRT qui dépendent de CoreWindow.

Événements

DataRequested	Se produit lorsqu’une opération de partage démarre.
ShareProvidersRequested	Événement déclenché lorsque les fournisseurs de partage sont demandés. Il est utilisé comme rappel et des fournisseurs sont ajoutés en s’abonnant à cet événement et en appelant ShareProvidersRequestedEventArgs.Providers.Add() dans le gestionnaire d’événements.
TargetApplicationChosen	Se produit lorsque l’utilisateur choisit une application cible dans l’interface utilisateur de partage.

Voir aussi

• Exemple d’application de source de contenu (Windows 10)