DataTransferManager Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.DataTransfer

Avvia a livello di codice uno scambio di contenuti con altre app.

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

Ereditarietà

Object Platform::Object IInspectable DataTransferManager

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

In questo esempio viene illustrato un modo tipico di usare l'oggetto 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!");
    });
}

Commenti

La classe DataTransferManager è una classe statica usata per avviare le operazioni di condivisione. Per usare la classe, chiamare prima il metodo GetForCurrentView . Questo metodo restituisce l'oggetto DataTransferManager specifico della finestra attiva. È quindi necessario aggiungere un listener eventi per l'evento datarequested all'oggetto. Questo evento viene attivato quando viene avviata un'operazione di condivisione, in genere quando l'utente tocca l'accesso alla condivisione, anche se viene attivata anche se l'app avvia un'operazione di condivisione a livello di codice.

La classe DataTransferManager include un metodo ShowShareUI che è possibile usare per avviare a livello di codice un'operazione di condivisione.

La classe DataTransferManager include anche un evento TargetApplicationChosen . Usare questo evento quando si vuole acquisire le applicazioni selezionate da un utente durante la condivisione del contenuto dall'app.

Nota

Questa classe non è agile, il che significa che è necessario considerare il relativo modello di threading e il comportamento di marshalling. Per altre informazioni, vedere Threading e marshalling (C++/CX) eUso di oggetti Windows Runtime in un ambiente multithreaded (.NET).

Windows Phone 8

Questa API è supportata solo nelle app native.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	IsSupported
1703	15063	ShareProvidersRequested
1709	16299	ShowShareUI(ShareUIOptions)

Metodi

GetForCurrentView()	Restituisce l'oggetto DataTransferManager associato alla finestra corrente.
IsSupported()	Restituisce true se il dispositivo supporta la condivisione, false in caso contrario.
ShowShareUI()	Avvia a livello di codice l'interfaccia utente per la condivisione del contenuto con un'altra app. Questa API è per le app UWP (piattaforma UWP (Universal Windows Platform)). L'API alternativa da usare per un'app desktop è descritta in Visualizzare oggetti interfaccia utente WinRT che dipendono da CoreWindow.
ShowShareUI(ShareUIOptions)	Avvia a livello di codice l'interfaccia utente per la condivisione del contenuto con un'altra app. Questa API è per le app UWP (piattaforma UWP (Universal Windows Platform)). L'API alternativa da usare per un'app desktop è descritta in Visualizzare oggetti interfaccia utente WinRT che dipendono da CoreWindow.

Eventi

DataRequested	Si verifica quando viene avviata un'operazione di condivisione.
ShareProvidersRequested	Evento attivato quando vengono richiesti i provider di condivisione. Questo viene usato come callback e provider vengono aggiunti sottoscrivendo questo evento e chiamando ShareProvidersRequestedEventArgs.Providers.Add() nel gestore eventi.
TargetApplicationChosen	Si verifica quando l'utente sceglie un'app di destinazione nell'interfaccia utente di condivisione.

Vedi anche

• Esempio di app di origine contenuto (Windows 10)