DataPackageView Kelas

  • Referensi

Definisi

Ruang nama:
Windows.ApplicationModel.DataTransfer
Edit

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
Object Platform::Object IInspectable DataPackageView
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 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