DataRequest.Data Properti

Definisi

Ruang nama:

Windows.ApplicationModel.DataTransfer

Mengatur atau mendapatkan objek DataPackage yang berisi konten yang ingin dibagikan pengguna.

public:
 property DataPackage ^ Data { DataPackage ^ get(); void set(DataPackage ^ value); };

DataPackage Data();

void Data(DataPackage value);

public DataPackage Data { get; set; }

var dataPackage = dataRequest.data;
dataRequest.data = dataPackage;

Public Property Data As DataPackage

Nilai Properti

DataPackage

Berisi konten yang ingin dibagikan pengguna.

Contoh

Kode berikut menunjukkan cara mendapatkan objek DataPackage dari properti Data sebagai bagian dari pengaturan data pada DataPackage untuk dibagikan dengan aplikasi lain.

//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

Properti Data memungkinkan aplikasi Anda untuk menyediakan data ke aplikasi target. Aplikasi Anda harus menyediakan data ini dengan menggunakan objek DataPackage .

Gunakan properti ini saat aplikasi Anda memiliki konten yang segera tersedia yang ingin dibagikan pengguna. Jika Anda perlu memanggil fungsi untuk menghasilkan DataPackage, gunakan metode GetDeferral .

Saat aplikasi Anda tidak dapat menyediakan objek DataPackage , gunakan metode FailWithDisplayText untuk membatalkan berbagi dan memberikan pesan yang dapat ditampilkan aplikasi target kepada pengguna.