DataRequest Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.DataTransfer

Memungkinkan aplikasi Anda menyediakan konten yang ingin dibagikan pengguna atau menentukan pesan, jika terjadi kesalahan.

public ref class DataRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataRequest

Public NotInheritable Class DataRequest

Warisan

Object Platform::Object IInspectable DataRequest

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute

Persyaratan Windows

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

Contoh

Kode berikut menunjukkan cara menggunakan objek DataRequest 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

Aplikasi Anda menerima objek DataRequest saat peristiwa yang diminta data terjadi. Dengan objek ini, aplikasi Anda dapat menyediakan data ke aplikasi target dengan menggunakan objek DataPackage , menggunakan objek penahanan untuk memanggil fungsi, atau menginformasikan aplikasi target bahwa terjadi kesalahan.

Properti

Data	Mengatur atau mendapatkan objek DataPackage yang berisi konten yang ingin dibagikan pengguna.
Deadline	Mendapatkan tenggat waktu untuk menyelesaikan operasi penyajian yang tertunda. Jika eksekusi melampaui tenggat waktu tersebut, hasil rendering yang tertunda diabaikan.

Metode

FailWithDisplayText(String)	Membatalkan operasi berbagi dan menyediakan string kesalahan untuk ditampilkan kepada pengguna.
GetDeferral()	Mendukung operasi berbagi asinkron dengan membuat dan mengembalikan objek DataRequestDeferral .