Bagikan melalui


DataTransferManager Kelas

Definisi

Secara terprogram memulai pertukaran konten dengan aplikasi lain.

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
Warisan
Object Platform::Object IInspectable DataTransferManager
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Contoh ini menunjukkan cara umum menggunakan objek 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!");
    });
}

Keterangan

Kelas DataTransferManager adalah kelas statis yang Anda gunakan untuk memulai operasi berbagi. Untuk menggunakan kelas , pertama-tama panggil metode GetForCurrentView . Metode ini mengembalikan objek DataTransferManager yang khusus untuk jendela aktif. Selanjutnya, Anda perlu menambahkan pendengar peristiwa untuk peristiwa yang diminta data ke objek . Peristiwa ini diaktifkan saat operasi berbagi dimulai— biasanya ketika pengguna mengetuk tombol Bagikan, meskipun juga diaktifkan jika aplikasi Anda memulai operasi berbagi secara terprogram.

Kelas DataTransferManager menyertakan metode ShowShareUI , yang dapat Anda gunakan untuk memulai operasi berbagi secara terprogram.

Kelas DataTransferManager juga memiliki peristiwa TargetApplicationChosen . Gunakan kejadian ini saat Anda ingin mengambil aplikasi apa yang dipilih pengguna saat berbagi konten dari aplikasi Anda.

Catatan

Kelas ini tidak tangkas, yang berarti Anda perlu mempertimbangkan model utas dan perilaku marshalingnya. Untuk informasi selengkapnya, lihat Threading dan Marshaling (C++/CX) dan Menggunakan objek Windows Runtime di lingkungan multithreaded (.NET).

Windows Phone 8

API ini hanya didukung di aplikasi asli.

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
1607 14393 Didukung
1703 15063 ShareProvidersRequested
1709 16299 ShowShareUI(ShareUIOptions)

Metode

GetForCurrentView()

Mengembalikan objek DataTransferManager yang terkait dengan jendela saat ini.

IsSupported()

Mengembalikan true jika perangkat mendukung berbagi, jika tidak salah.

ShowShareUI()

Secara terprogram memulai antarmuka pengguna untuk berbagi konten dengan aplikasi lain.

API ini untuk aplikasi Platform Windows Universal (UWP). API alternatif yang digunakan untuk aplikasi desktop dijelaskan dalam objek UI Display WinRT yang bergantung pada CoreWindow.

ShowShareUI(ShareUIOptions)

Secara terprogram memulai antarmuka pengguna untuk berbagi konten dengan aplikasi lain.

API ini untuk aplikasi Platform Windows Universal (UWP). API alternatif yang digunakan untuk aplikasi desktop dijelaskan dalam objek UI Display WinRT yang bergantung pada CoreWindow.

Acara

DataRequested

Terjadi ketika operasi berbagi dimulai.

ShareProvidersRequested

Peristiwa yang dipicu saat penyedia berbagi diminta. Ini digunakan sebagai panggilan balik dan penyedia ditambahkan dengan berlangganan kejadian ini dan memanggil ShareProvidersRequestedEventArgs.Providers.Add() di penanganan aktivitas.

TargetApplicationChosen

Terjadi saat pengguna memilih aplikasi target di UI Berbagi.

Berlaku untuk

Lihat juga