Bagikan melalui


DataPackage Kelas

Definisi

Berisi data yang ingin ditukar pengguna dengan aplikasi lain.

public ref class DataPackage sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataPackage final
/// [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")]
class DataPackage final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataPackage
[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")]
public sealed class DataPackage
[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

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.

Berlaku untuk

Lihat juga