Partage via


DataTransferManager Classe

Définition

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)]
class DataTransferManager final
/// [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)]
public sealed class DataTransferManager
[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

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.

S’applique à

Voir aussi