Share via

DataTransferManager Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.ApplicationModel.DataTransfer
Modifica

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)]
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
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.

Si applica a

Vedi anche