Freigeben über


DataTransferManager Klasse

Definition

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)]
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
Vererbung
Object Platform::Object IInspectable DataTransferManager
Attribute

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.

Gilt für:

Weitere Informationen