DataTransferManager Klasse

Definition

Namespace:

Windows.ApplicationModel.DataTransfer

Initiiert programmgesteuert einen Austausch von Inhalten mit anderen Apps.

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

Vererbung

Object Platform::Object IInspectable DataTransferManager

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Dieses Beispiel zeigt eine typische Verwendung des DataTransferManager-Objekts .

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!");
    });
}

Hinweise

Die DataTransferManager-Klasse ist eine statische Klasse, die Sie zum Initiieren von Freigabevorgängen verwenden. Um die -Klasse zu verwenden, rufen Sie zuerst die GetForCurrentView-Methode auf. Diese Methode gibt das DataTransferManager-Objekt zurück, das für das aktive Fenster spezifisch ist. Als Nächstes müssen Sie dem -Objekt einen Ereignislistener für das datarequested-Ereignis hinzufügen. Dieses Ereignis wird ausgelöst, wenn ein Freigabevorgang gestartet wird– in der Regel, wenn der Benutzer auf den Charm Freigeben tippt, obwohl es auch ausgelöst wird, wenn Ihre App einen Freigabevorgang programmgesteuert startet.

Die DataTransferManager-Klasse enthält eine ShowShareUI-Methode , mit der Sie einen Freigabevorgang programmgesteuert starten können.

Die DataTransferManager-Klasse verfügt auch über ein TargetApplicationChosen-Ereignis . Verwenden Sie dieses Ereignis, wenn Sie erfassen möchten, welche Anwendungen ein Benutzer beim Freigeben von Inhalten aus Ihrer App auswählt.

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallingverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading and Marshaling (C++/CX) und Using Windows-Runtime objects in a multithreaded environment (.NET).

Windows Phone 8

Diese API wird nur in nativen Apps unterstützt.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1607	14393	Issupported
1703	15063	ShareProvidersRequested
1709	16299	ShowShareUI(ShareUIOptions)

Methoden

GetForCurrentView()	Gibt das DataTransferManager-Objekt zurück, das dem aktuellen Fenster zugeordnet ist.
IsSupported()	Gibt true zurück, wenn das Gerät die Freigabe unterstützt, andernfalls false.
ShowShareUI()	Initiiert programmgesteuert die Benutzeroberfläche für die Freigabe von Inhalten mit einer anderen App. Diese API ist für Universelle Windows-Plattform-Apps (UWP) vorgesehen. Die alternative API für eine Desktop-App wird unter Anzeigen von WinRT-UI-Objekten beschrieben, die von CoreWindow abhängen.
ShowShareUI(ShareUIOptions)	Initiiert programmgesteuert die Benutzeroberfläche für die Freigabe von Inhalten mit einer anderen App. Diese API ist für Universelle Windows-Plattform-Apps (UWP) vorgesehen. Die alternative API für eine Desktop-App wird unter Anzeigen von WinRT-UI-Objekten beschrieben, die von CoreWindow abhängen.

Ereignisse

DataRequested	Tritt auf, wenn ein Freigabevorgang gestartet wird.
ShareProvidersRequested	Ein Ereignis, das ausgelöst wird, wenn die Freigabeanbieter angefordert werden. Dies wird als Rückruf verwendet, und Anbieter werden hinzugefügt, indem sie dieses Ereignis abonnieren und ShareProvidersRequestedEventArgs.Providers.Add() im Ereignishandler aufrufen.
TargetApplicationChosen	Tritt auf, wenn der Benutzer eine Ziel-App auf der Benutzeroberfläche freigeben auswäht.

Weitere Informationen

• Beispiel für die Quell-App zum Freigeben von Inhalten (Windows 10)