DataTransferManager Class

Initialise par programmation un échange de contenu avec d'autres applications.

Syntaxe


var dataTransferManager = Windows.ApplicationModel.DataTransfer.DataTransferManager.getForCurrentView();

Attributs

[MarshalingBehavior(Standard)]
[Muse()]
[Version(0x06020000)]

Membres

DataTransferManagerClasse possède ces types de membres :

Événements

DataTransferManagerClasse possède ces événements.

ÉvénementDescription
DataRequested Occurs when a share operation starts.
TargetApplicationChosen Occurs when the user chooses a target app in the Share charm.

 

Méthodes

The DataTransferManager Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
GetForCurrentView Returns the DataTransferManager object associated with the current window.
ShowShareUI Programmatically initiates the user interface for sharing content with another app.

 

Remarques

La classe DataTransferManager est une classe statique que vous utilisez pour initialiser des opérations de partage. Pour utiliser la classe, appelez d'abord la méthode GetForCurrentView. Cette méthode retourne l'objet DataTransferManager qui est propre à la fenêtre active. Ensuite, vous devez ajouter à l'objet un écouteur d'événements pour l'événement datarequested. Cet événement est déclenché lorsqu'une opération de partage démarre—, en général lorsque l'utilisateur touche le talisman de partage, bien qu'il soit aussi déclenché si votre application démarre une opération de partage par programme.

La classe DataTransferManager inclut une méthode ShowShareUI, que vous pouvez utiliser pour démarrer par programme une opération de partage. En général, nous recommandons l'utilisation de cette méthode. Les utilisateurs s'attendent à initialiser les opérations de partage à l'aide du talisman de partage—lorsque vous exécutez l'opération par programme, vous pouvez créer une expérience utilisateur incohérente. Nous incluons la méthode, car il existe quelques scénarios dans lesquels l'utilisateur ne peut pas identifier les possibilités de partage. Un bon exemple est lorsque l'utilisateur effectue un score supérieur dans un jeu.

La classe DataTransferManager comporte également un événement TargetApplicationChosen. Utilisez cet événement lorsque vous souhaitez capturer les applications qu'un utilisateur sélectionne lorsqu'il partage le contenu de votre application.

Remarque   : 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 les rubriques Threads et marshaling (C++/CX) et Utilisation d'objets Windows Runtime dans un environnement multithread (.NET).

Windows Phone 8

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

Exemples

Cet exemple montre une manière classique d'utiliser 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!");
        });
    }


Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Téléphone minimal pris en charge

Windows Phone 8

Espace de noms

Windows.ApplicationModel.DataTransfer
Windows::ApplicationModel::DataTransfer [C++]

Métadonnées

Windows.winmd

 

 

Afficher:
© 2014 Microsoft