Bagikan melalui


DataObject Kelas

Definisi

Menyediakan implementasi IDataObject dasar antarmuka, yang mendefinisikan mekanisme format independen untuk mentransfer data.

public ref class DataObject sealed : System::Runtime::InteropServices::ComTypes::IDataObject, System::Windows::IDataObject
public sealed class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.IDataObject
type DataObject = class
    interface IDataObject
    interface IDataObject
Public NotInheritable Class DataObject
Implements IDataObject, IDataObject
Warisan
DataObject
Penerapan

Contoh

Contoh berikut menunjukkan cara menggunakan kelas ini.

string stringData = "Some string data to store...";
string dataFormat = DataFormats.UnicodeText;
DataObject dataObject = new DataObject(dataFormat, stringData);
Dim stringData As String = "Some string data to store..."
Dim dataFormat As String = DataFormats.UnicodeText
Dim dataObject As New DataObject(dataFormat, stringData)

Keterangan

Penting

Metode panggilan dari kelas ini dengan data yang tidak tepercaya adalah risiko keamanan. Panggil metode dari kelas ini hanya dengan data tepercaya. Untuk informasi selengkapnya, lihat Memvalidasi Semua Input.

Konstruktor

DataObject()

Menginisialisasi instans baru kelas DataObject.

DataObject(Object)

Menginisialisasi instans baru kelas DataObject yang berisi data yang ditentukan.

DataObject(String, Object)

Menginisialisasi instans DataObject baru kelas yang berisi data yang ditentukan dan format terkaitnya; format ditentukan oleh string.

DataObject(String, Object, Boolean)

Menginisialisasi instans DataObject baru kelas yang berisi data yang ditentukan dan format terkaitnya; format ditentukan oleh string. Kelebihan beban ini mencakup Boolean bendera untuk menunjukkan apakah data dapat dikonversi ke format lain saat pengambilan.

DataObject(Type, Object)

Menginisialisasi instans DataObject baru kelas yang berisi data yang ditentukan dan format terkaitnya; format data ditentukan oleh Type objek.

Bidang

CopyingEvent

Mengidentifikasi peristiwa terlampir Copying .

PastingEvent

Mengidentifikasi peristiwa terlampir Pasting .

SettingDataEvent

Mengidentifikasi peristiwa terlampir SettingData .

Metode

AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Copying Menambahkan penanganan aktivitas ke objek dependensi tertentu.

AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)

Pasting Menambahkan penanganan aktivitas ke objek dependensi tertentu.

AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

SettingData Menambahkan penanganan aktivitas ke objek dependensi tertentu.

ContainsAudio()

Mengkueri objek data untuk keberadaan data dalam WaveAudio format data.

ContainsFileDropList()

Mengkueri objek data untuk keberadaan data dalam FileDrop format data.

ContainsImage()

Mengkueri objek data untuk keberadaan data dalam Bitmap format data.

ContainsText()

Mengkueri objek data untuk keberadaan data dalam UnicodeText format.

ContainsText(TextDataFormat)

Mengkueri objek data untuk keberadaan data dalam format data teks.

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetAudioStream()

Mengembalikan aliran yang berisi data dalam WaveAudio format data.

GetData(String)

Mengembalikan data dalam format yang ditentukan oleh string.

GetData(String, Boolean)

Mengembalikan objek data dalam format tertentu, secara opsional mengonversi data ke format yang ditentukan.

GetData(Type)

Mengembalikan objek data dalam format yang ditentukan oleh Type objek.

GetDataPresent(String)

Menentukan apakah data tersedia di, atau dapat dikonversi ke, format yang ditentukan oleh string.

GetDataPresent(String, Boolean)

Menentukan apakah data tersedia, atau dapat dikonversi ke, format tertentu. Boolean Bendera menunjukkan apakah akan memeriksa apakah data dapat dikonversi ke format yang ditentukan jika tidak tersedia dalam format tersebut.

GetDataPresent(Type)

Menentukan apakah data tersedia, atau dapat dikonversi ke, format yang ditentukan oleh Type objek.

GetFileDropList()

Mengembalikan kumpulan string yang berisi daftar file yang dijatuhkan.

GetFormats()

Mengembalikan daftar format tempat data dalam objek data ini disimpan, atau dapat dikonversi.

GetFormats(Boolean)

Mengembalikan daftar format tempat data dalam objek data ini disimpan. Boolean Bendera menunjukkan apakah juga akan menyertakan format tempat data dapat dikonversi secara otomatis.

GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetImage()

Mengembalikan objek yang BitmapSource berisi data dalam Bitmap format .

GetText()

Mengembalikan string yang berisi UnicodeText data dalam objek data ini.

GetText(TextDataFormat)

Mengembalikan string yang berisi data teks dari format yang ditentukan dalam objek data ini.

GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Copying Menghapus penanganan aktivitas dari objek dependensi tertentu.

RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)

Pasting Menghapus penanganan aktivitas dari objek dependensi tertentu.

RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

SettingData Menghapus penanganan aktivitas dari objek dependensi tertentu.

SetAudio(Byte[])

Menyimpan data audio (WaveAudio format data) dalam objek data ini. Data audio ditentukan sebagai array byte.

SetAudio(Stream)

Menyimpan data audio (WaveAudio format data) dalam objek data ini. Data audio ditentukan sebagai aliran.

SetData(Object)

Menyimpan data yang ditentukan dalam objek data ini, secara otomatis menentukan format data dari jenis objek sumber.

SetData(String, Object)

Menyimpan data yang ditentukan dalam objek data ini, bersama dengan satu atau beberapa format data yang ditentukan; format data ditentukan oleh string.

SetData(String, Object, Boolean)

Menyimpan data yang ditentukan dalam objek data ini, bersama dengan satu atau beberapa format data yang ditentukan. Kelebihan beban ini mencakup Boolean bendera untuk menunjukkan apakah data dapat dikonversi ke format lain saat pengambilan.

SetData(Type, Object)

Menyimpan data yang ditentukan dalam objek data ini, bersama dengan satu atau beberapa format data yang ditentukan; format data ditentukan oleh Type objek .

SetFileDropList(StringCollection)

FileDrop Menyimpan data dalam objek data ini. Daftar file yang dihilangkan ditentukan sebagai kumpulan string.

SetImage(BitmapSource)

Bitmap Menyimpan data dalam objek data ini. Data gambar ditentukan sebagai BitmapSource.

SetText(String)

UnicodeText Menyimpan data, yang ditentukan sebagai string, dalam objek data ini.

SetText(String, TextDataFormat)

Menyimpan data teks dalam objek data ini. Format data teks yang akan disimpan ditentukan dengan anggota TextDataFormat.

ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Acara yang Terlampir

Copying

Terjadi ketika objek dependensi terkait telah menyiapkan format data yang sesuai yang mewakili pilihan salin, menambahkan format pilihan salinan ke DataObject, dan siap untuk menempatkan DataObject pada Clipboard atau memulai operasi seret dan letakkan.

Pasting

Terjadi ketika objek dependensi terkait siap untuk menempelkan data.

SettingData

Terjadi ketika objek dependensi terkait mencoba menambahkan format data baru ke DataObject.

Implementasi Antarmuka Eksplisit

IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

Membuat koneksi antara objek data dan sink penasihat. Metode ini dipanggil oleh objek yang mendukung sink penasihat dan memungkinkan sink penasihat untuk diberi tahu tentang perubahan dalam data objek.

IDataObject.DUnadvise(Int32)

Menghancurkan koneksi pemberitahuan yang telah dibuat sebelumnya.

IDataObject.EnumDAdvise(IEnumSTATDATA)

Membuat objek yang dapat digunakan untuk menghitung koneksi penasihat saat ini.

IDataObject.EnumFormatEtc(DATADIR)

Membuat objek untuk menghitung FORMATETC struktur untuk objek data. Struktur ini digunakan dalam panggilan ke GetData(FORMATETC, STGMEDIUM) atau SetData(FORMATETC, STGMEDIUM, Boolean).

IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Menyediakan struktur standar FORMATETC yang secara logis setara dengan struktur yang lebih kompleks. Gunakan metode ini untuk menentukan apakah dua struktur yang berbeda FORMATETC akan mengembalikan data yang sama, menghilangkan kebutuhan akan penyajian duplikat.

IDataObject.GetData(FORMATETC, STGMEDIUM)

Mendapatkan data dari objek data sumber. Metode GetData(FORMATETC, STGMEDIUM) , yang dipanggil oleh konsumen data, merender data yang dijelaskan dalam struktur yang ditentukan FORMATETC dan mentransfernya melalui struktur yang ditentukan STGMEDIUM . Pemanggil kemudian bertanggung jawab untuk merilis STGMEDIUM struktur.

IDataObject.GetDataHere(FORMATETC, STGMEDIUM)

Mendapatkan data dari objek data sumber. Metode ini, yang dipanggil oleh konsumen data, berbeda dari GetData(FORMATETC, STGMEDIUM) metode di mana pemanggil harus mengalokasikan dan membebaskan media penyimpanan yang ditentukan.

IDataObject.QueryGetData(FORMATETC)

Menentukan apakah objek data mampu merender data yang dijelaskan dalam FORMATETC struktur. Objek yang mencoba operasi tempel atau jatuhkan dapat memanggil metode ini sebelum memanggil GetData(FORMATETC, STGMEDIUM) untuk mendapatkan indikasi apakah operasi mungkin berhasil.

IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)

Mentransfer data ke objek yang mengimplementasikan metode ini. Metode ini dipanggil oleh objek yang berisi sumber data.

Berlaku untuk

Lihat juga