IDataObject Antarmuka
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.
Menyediakan mekanisme format independen untuk mentransfer data.
public interface class IDataObject[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObjectpublic interface IDataObject[<System.Runtime.InteropServices.ComVisible(true)>]
type IDataObject = interfacetype IDataObject = interfacePublic Interface IDataObject- Turunan
- Atribut
Keterangan
Antarmuka IDataObject digunakan oleh Clipboard kelas dan dalam operasi seret dan letakkan.
Saat diimplementasikan di kelas, IDataObject metode memungkinkan pengguna untuk menyimpan data dalam beberapa format dalam instans kelas. Menyimpan data dalam lebih dari satu format meningkatkan kemungkinan aplikasi target, yang persyaratan formatnya mungkin tidak Anda ketahui, dapat mengambil data yang disimpan. Untuk menyimpan data dalam instans IDataObject, panggil SetData metode dan tentukan format data dalam format parameter . Atur parameter ke autoConvertfalse jika Anda tidak ingin data tersimpan dikonversi ke format lain saat diambil. Panggil SetData beberapa kali pada satu instans IDataObject untuk menyimpan data dalam lebih dari satu format.
Anda mengambil data yang IDataObject disimpan dari dengan memanggil GetData metode dan menentukan format data dalam format parameter . Atur autoConvert parameter ke false untuk mengambil hanya data yang disimpan dalam format yang ditentukan. Untuk mengonversi data yang disimpan ke format yang ditentukan, atur autoConvert ke true, atau jangan gunakan autoConvert.
Untuk menentukan format data yang disimpan dalam IDataObject, gunakan metode berikut IDataObject .
GetFormats Panggil metode untuk mengambil array dari semua format tempat data tersedia. Atur
autoConvertparameter kefalseuntuk mendapatkan hanya format tempat data disimpan. Untuk mendapatkan semua format tempat data tersedia, aturautoConvertketrue, atau jangan gunakan parameter ini.GetDataPresent Panggil metode untuk menentukan apakah data tersimpan tersedia dalam format tertentu. Jika Anda tidak ingin data tersimpan dikonversi ke format yang ditentukan, atur parameter ke
autoConvertfalse.
DataObject Lihat kelas untuk implementasi antarmuka ini. DataFormats Lihat kelas untuk format data yang telah Clipboard ditentukan sebelumnya.
Metode
| Nama | Deskripsi |
|---|---|
| GetData(String, Boolean) |
Mengambil data yang terkait dengan format data yang ditentukan, menggunakan Boolean untuk menentukan apakah akan mengonversi data ke format. |
| GetData(String) |
Mengambil data yang terkait dengan format data yang ditentukan. |
| GetData(Type) |
Mengambil data yang terkait dengan format jenis kelas yang ditentukan. |
| GetDataPresent(String, Boolean) |
Menentukan apakah data yang disimpan dalam instans ini dikaitkan dengan format yang ditentukan, menggunakan nilai Boolean untuk menentukan apakah akan mengonversi data ke format. |
| GetDataPresent(String) |
Menentukan apakah data yang disimpan dalam instans ini dikaitkan dengan, atau dapat dikonversi ke, format yang ditentukan. |
| GetDataPresent(Type) |
Menentukan apakah data yang disimpan dalam instans ini dikaitkan dengan, atau dapat dikonversi ke, format yang ditentukan. |
| GetFormats() |
Mengembalikan daftar semua format yang disimpan data dalam instans ini dikaitkan dengan atau dapat dikonversi. |
| GetFormats(Boolean) |
Mendapatkan daftar semua format yang disimpan data dalam instans ini dikaitkan dengan atau dapat dikonversi ke, menggunakan nilai Boolean untuk menentukan apakah akan mengambil semua format yang dapat dikonversi data ke atau hanya format data asli. |
| SetData(Object) |
Menyimpan data yang ditentukan dalam instans ini, menggunakan kelas data untuk format tersebut. |
| SetData(String, Boolean, Object) |
Menyimpan data yang ditentukan dan format terkait dalam instans ini, menggunakan nilai Boolean untuk menentukan apakah data dapat dikonversi ke format lain. |
| SetData(String, Object) |
Menyimpan data yang ditentukan dan format terkait dalam instans ini. |
| SetData(Type, Object) |
Menyimpan data yang ditentukan dan jenis kelas terkait dalam instans ini. |
Metode Ekstensi
| Nama | Deskripsi |
|---|---|
| TryGetData<T>(IDataObject, String, Boolean, T) |
Menyediakan mekanisme format independen untuk mentransfer data. |
| TryGetData<T>(IDataObject, String, Func<TypeName,Type>, Boolean, T) |
Menyediakan mekanisme format independen untuk mentransfer data. |
| TryGetData<T>(IDataObject, String, T) |
Menyediakan mekanisme format independen untuk mentransfer data. |
| TryGetData<T>(IDataObject, T) |
Menyediakan mekanisme format independen untuk mentransfer data. |
