StandardDataFormats Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.DataTransfer

Berisi properti statis yang mengembalikan nilai string. Setiap string sesuai dengan ID format yang diketahui. Gunakan kelas ini untuk menghindari kesalahan dalam menggunakan konstanta string untuk menentukan format data.

public ref class StandardDataFormats abstract sealed

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

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

Public Class StandardDataFormats

Warisan

Object Platform::Object IInspectable StandardDataFormats

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

Contoh ini memperlihatkan cara mengambil teks bersama (dengan menggunakan StandardDataFormats.Text) atau file atau folder bersama (dengan menggunakan StandardDataFormats.StorageItems). Untuk contoh selengkapnya, lihat sampel Clipboard dan sampel ShareTarget.

public async Task ActivateAsync(ShareTargetActivatedEventArgs args)
{
    ShareOperation shareOperation = args.ShareOperation;
    if (shareOperation.Data.Contains(StandardDataFormats.Text))
    {
        string text = await shareOperation.Data.GetTextAsync();

        // To output the text from this example, you need a TextBlock control
        // with a name of "sharedContent".
        sharedContent.Text = "Text: " + text;
    }

    if (shareOperation.Data.Contains(StandardDataFormats.StorageItems)) 
    {
        shareOperation.ReportStarted();
        IReadOnlyList<IStorageItem> storageItems = null;
        storageItems = await shareOperation.Data.GetStorageItemsAsync();
        string fileList = String.Empty;

        for (int index = 0; index < storageItems.Count; index++) 
        {
            fileList += storageItems[index].Name;
                if (index < storageItems.Count - 1) {
                    fileList += ", ";
                }
            }

        // To output the text from this example, you need a TextBlock control
        // with a name of "sharedContent".
        sharedContent.Text += "StorageItems: " + fileList + Environment.NewLine;

        shareOperation.ReportCompleted();
    }

    Window.Current.Content = this;
    Window.Current.Activate();
}

Keterangan

Kelas DataPackage mendukung beberapa jenis format. Setiap kali Anda perlu menentukan format, sebaiknya gunakan properti kelas StandardDataFormats , bukan nilai string. Melakukannya memastikan konsistensi antara aplikasi sumber dan target.

Kelas DataPackage mendukung sejumlah format warisan untuk interoperabilitas antara aplikasi UWP dan aplikasi desktop. Untuk mengambil format ini, Anda meneruskan salah satu string berikut ke metode DataPackageView.GetDataAsync alih-alih nilai dari kelas StandardDataFormats .

Jika nama format adalah:	GetDataAsync() mengambil:
"AnsiText"	String untuk CF_TEXT.
"DeviceIndependentBitmap"	Streaming untuk HGLOBAL yang sesuai dengan CF_DIB.
"DeviceIndependentBitmapV5"	Streaming untuk HGLOBAL yang sesuai dengan CF_DIBV5.
"DataInterchangeFormat"	Streaming untuk HGLOBAL yang sesuai dengan CF_DIF.
"EnhancedMetafile"	Streaming untuk HENHMETAFILE yang sesuai dengan CF_ENHMETAFILE.
"Lokal"	Streaming untuk HGLOBAL yang sesuai dengan CF_LOCALE
"OEMText"	String untuk CF_OEMTEXT.
"PenData"	Streaming untuk HGLOBAL yang sesuai dengan CF_PENDATA
"RiffAudio"	Streaming untuk HGLOBAL yang sesuai dengan CF_RIFF.
"SymbolicLink"	Streaming untuk HGLOBAL yang sesuai dengan CF_SYLK.
"TaggedImageFileFormat"	Streaming untuk HGLOBAL yang sesuai dengan CF_TIFF.
"WaveAudio"	Streaming untuk HGLOBAL yang sesuai dengan CF_WAVE.

Windows Runtime menyediakan dukungan terbatas untuk metafiles. Secara khusus, Windows Runtime:

• Mendukung penyajian metafiles, tetapi tidak membuatnya.
• Mendukung format CF_ENHMETAFILE ("EnhancedMetafile"), tetapi tidak CF_METAFILEPICT.
• Mendukung permintaan data dalam format "EnhancedMetafile", tetapi tidak menyediakannya; Artinya, panggilan SetData("EnhancedMetafile", <data>) tidak akan berfungsi.
• Memberikan dukungan terbatas melalui API clipboard untuk bertukar metafiles antara aplikasi UWP dan aplikasi desktop.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1803	17134	UserActivityJsonArray

Properti

ApplicationLink	Properti baca-saja yang mengembalikan nilai string ID format yang sesuai dengan format tautan aktivasi.
Bitmap	Properti baca-saja yang mengembalikan nilai string ID format yang sesuai dengan format Bitmap.
Html	Properti baca-saja yang mengembalikan nilai string ID format yang sesuai dengan format HTML.
Rtf	Properti baca-saja yang mengembalikan nilai string ID format yang terkait dengan Format Teks Kaya (RTF).
StorageItems	Properti baca-saja yang mengembalikan nilai string ID format yang sesuai dengan format item penyimpanan (untuk file dan folder).
Text	Properti baca-saja yang mengembalikan nilai string ID format yang terkait dengan format Teks.
Uri	Catatan Uri dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan ApplicationLink atau WebLink. Properti baca-saja yang mengembalikan nilai string ID format yang sesuai dengan format Pengidentifikasi Sumber Daya Seragam (URI).
UserActivityJsonArray	Properti baca-saja yang mengembalikan nilai string ID format yang sesuai dengan format array JSON UserActivity .
WebLink	Properti baca-saja yang mengembalikan nilai string ID format yang sesuai dengan format tautan web.