DataPackage Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.DataTransfer

Berisi data yang ingin ditukar pengguna dengan aplikasi lain.

public ref class DataPackage sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DataPackage final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DataPackage

function DataPackage()

Public NotInheritable Class DataPackage

Warisan

Object Platform::Object IInspectable DataPackage

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

//To see this code in action, add a call to ShareSourceLoad to your constructor or other
//initializing function.
private void ShareSourceLoad()
{
    DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();
    dataTransferManager.DataRequested += new TypedEventHandler<DataTransferManager, DataRequestedEventArgs>(this.DataRequested);
}

private void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequest request = e.Request;
    request.Data.Properties.Title = "Share Text Example";
    request.Data.Properties.Description = "An example of how to share text.";
    request.Data.SetText("Hello World!");
}

Keterangan

Selama operasi berbagi, aplikasi sumber menempatkan data yang dibagikan dalam objek DataPackage dan mengirim objek tersebut ke aplikasi target untuk diproses. Kelas DataPackage mencakup sejumlah metode untuk mendukung format default berikut: teks, Rtf, Html, Bitmap, dan StorageItems. Ini juga memiliki metode untuk mendukung format data kustom. Untuk menggunakan format ini, aplikasi sumber dan aplikasi target harus sudah mengetahui bahwa format kustom ada.

Aplikasi sumber memiliki opsi untuk menggunakan SetDataProvider untuk menetapkan delegasi ke DataPackage, alih-alih segera menyediakan data. Proses ini berguna ketika aplikasi sumber mendukung format tertentu tetapi tidak ingin menghasilkan data kecuali aplikasi target meminta data. Misalnya, aplikasi sumber mungkin mendukung berbagai format gambar untuk berbagi foto. Alih-alih membuat beberapa salinan setiap gambar menggunakan format ini, aplikasi sumber dapat menggunakan delegasi yang dipanggil saat aplikasi target meminta jenis format tertentu.

Aplikasi target dapat menggunakan objek DataPackageView untuk memperoleh data yang dibagikan. Selain itu, aplikasi ini dapat menggunakan properti AvailableFormats untuk mengidentifikasi format mana yang didukung DataPackageView , atau menggunakan metode Contains untuk mengkueri format tertentu.

Windows Phone 8

API ini hanya didukung di aplikasi asli.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1703	15063	ShareCompleted
2004	19041	ShareCanceled

Konstruktor

DataPackage()

Konstruktor yang membuat DataPackage baru.

Properti

Properties	Memungkinkan Anda untuk mendapatkan dan mengatur properti seperti judul konten yang dibagikan.
RequestedOperation	Menentukan DataPackageOperation (tidak ada, pindahkan, salin, atau tautan) untuk operasi.
ResourceMap	Memetakan URI ke file. Digunakan untuk memastikan bahwa konten yang dirujuk (seperti gambar) dalam konten HTML ditambahkan ke DataPackage.

Metode

GetView()	Mengembalikan objek DataPackageView . Objek ini adalah salinan baca-saja dari objek DataPackage .
SetApplicationLink(Uri)	Mengatur tautan aplikasi yang dikandung DataPackage .
SetBitmap(RandomAccessStreamReference)	Mengatur gambar bitmap yang terkandung dalam DataPackage.
SetData(String, Object)	Mengatur data yang terkandung dalam DataPackage dalam format RandomAccessStream .
SetDataProvider(String, DataProviderHandler)	Mengatur delegasi untuk menangani permintaan dari aplikasi target.
SetHtmlFormat(String)	Menambahkan konten HTML ke DataPackage.
SetRtf(String)	Mengatur konten Rich Text Format (RTF) yang terkandung dalam DataPackage.
SetStorageItems(IIterable<IStorageItem>)	Mengatur file dan folder yang terkandung dalam DataPackage.
SetStorageItems(IIterable<IStorageItem>, Boolean)	Menambahkan file dan folder ke DataPackage.
SetText(String)	Mengatur teks yang dikandung DataPackage .
SetUri(Uri)	Catatan SetUri dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan ApplicationLink atau WebLink. Mengatur Pengidentifikasi Sumber Daya Seragam (URI) yang terkandung dalam DataPackage.
SetWebLink(Uri)	Mengatur tautan web yang dikandung DataPackage .

Acara

Destroyed	Terjadi ketika DataPackage dihancurkan.
OperationCompleted	Terjadi ketika operasi penempelan selesai.
ShareCanceled	Dimunculkan saat berbagi dibatalkan.
ShareCompleted	Peristiwa yang dipicu saat berbagi selesai. Berbagi dapat dikirim ke aplikasi, penyedia, atau kontak.

Lihat juga

• Sampel Clipboard (Windows 10)
• Berbagi sampel aplikasi sumber konten (Windows 10)