DataPackageView Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Versi baca-saja dari DataPackage. Aplikasi yang menerima konten bersama mendapatkan objek ini saat memperoleh konten.
public ref class DataPackageView sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataPackageView final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataPackageView
Public NotInheritable Class DataPackageView
- Warisan
- Atribut
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 DataPackageView untuk mendapatkan teks yang dibagikan. Agar contoh ini berfungsi dengan baik, Anda perlu menambahkan kode yang mendeteksi apakah aplikasi Anda diluncurkan sebagai respons terhadap operasi berbagi. Lihat topik kami, Cara menerima teks untuk mempelajari lebih lanjut.
var shareOperation = eventObject.detail.shareOperation;
if (shareOperation.data.contains(Windows.ApplicationModel.DataTransfer.StandardDataFormats.text)) {
shareOperation.data.getTextAsync().done(function (text) {
// To output the text using this example,
// you need a div tag with an id of "output" in your HTML file.
document.getElementById("output").innerText = text;
}, function (e) {
displayError("Error retrieving Text format: " + e);
}
});
}
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 target dapat menggunakan objek DataPackageView untuk memperoleh data yang dibagikan. Selain itu, aplikasi ini dapat menggunakan properti AvailableFormats untuk mengidentifikasi format apa yang didukung DataPackageView, atau metode Contains untuk mengkueri format tertentu.
Aplikasi sumber memiliki opsi untuk menggunakan SetDataProvider untuk menetapkan delegasi ke DataPackage, alih-alih segera menyediakan data. Proses ini berguna dalam situasi di mana aplikasi sumber mendukung format tertentu tetapi tidak ingin menghasilkan data kecuali aplikasi target memintanya. 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.
Riwayat versi
Versi Windows | Versi SDK | Nilai ditambahkan |
---|---|---|
1511 | 10586 | SetAcceptedFormatId |
Properti
AvailableFormats |
Mengembalikan format yang dikandung DataPackageView . |
Properties |
Mendapatkan objek DataPackagePropertySetView , yang berisi sekumpulan properti baca-saja untuk data di objek DataPackageView . |
RequestedOperation |
Mendapatkan operasi yang diminta (seperti menyalin atau memindahkan). Terutama digunakan untuk tindakan Clipboard. |
Metode
Contains(String) |
Memeriksa untuk melihat apakah DataPackageView berisi format data tertentu. |
GetApplicationLinkAsync() |
Mendapatkan tautan aplikasi di objek DataPackageView . |
GetBitmapAsync() |
Mendapatkan gambar bitmap yang terkandung dalam DataPackageView |
GetDataAsync(String) |
Mendapatkan data yang terkandung dalam DataPackageView. |
GetHtmlFormatAsync() |
Mendapatkan HTML yang disimpan di objek DataPackageView . |
GetResourceMapAsync() |
Mendapatkan data (seperti gambar) yang dirujuk dalam konten HTML. |
GetRtfAsync() |
Mendapatkan konten berformat teks kaya (RTF) yang terkandung dalam DataPackageView. |
GetStorageItemsAsync() |
Mendapatkan file dan folder yang disimpan dalam objek DataPackageView . |
GetTextAsync() |
Mendapatkan teks di objek DataPackageView . |
GetTextAsync(String) |
Mendapatkan teks di objek DataPackageView . |
GetUriAsync() |
Catatan GetUriAsync dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan GetApplicationLink atau GetWebLink. Mendapatkan URI yang terkandung dalam DataPackageView. |
GetWebLinkAsync() |
Mendapatkan tautan web di objek DataPackageView . |
ReportOperationCompleted(DataPackageOperation) |
Menginformasikan sistem bahwa aplikasi Anda selesai menggunakan objek DataPackageView . Terutama digunakan untuk operasi Clipboard. |
RequestAccessAsync() |
Meminta izin untuk membuka kunci dan mengakses paket data yang diamankan dengan kebijakan perlindungan. |
RequestAccessAsync(String) |
Meminta izin untuk membuka kunci dan mengakses paket data yang diamankan dengan kebijakan perlindungan. |
SetAcceptedFormatId(String) |
Mengatur Id format yang diterima. |
UnlockAndAssumeEnterpriseIdentity() |
Membuka kunci paket data dan mengasumsikan identitas perusahaan untuk itu. |
Berlaku untuk
Lihat juga
- Berbagi sampel aplikasi target konten
- Mulai cepat: Berbagi konten ( menggunakan JavaScript)
- Berbagi data
- Mulai cepat: Menerima konten bersama ( menggunakan JavaScript)
- Menerima data
- Berbagi sampel aplikasi target konten (Windows 10)
- Berbagi sampel aplikasi sumber konten (Windows 10)
- Sampel informasi paket aplikasi (Windows 10)