DataTransferManager Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 DataTransferManagerPublic NotInheritable Class DataTransferManager- Ereditarietà
- Attributi
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. |