DataTransferManager Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.DataTransfer

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)]
/// [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

Warisan

Object Platform::Object IInspectable DataTransferManager

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Lihat juga

• Berbagi sampel aplikasi sumber konten (Windows 10)