IDataObject Interfész

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

IDataObject.cs

Formátumfüggetlen mechanizmust biztosít az adatok átviteléhez.

public interface class IDataObject

public interface IDataObject

type IDataObject = interface

Public Interface IDataObject

Származtatott

System.Windows.Forms.DataObject

System.Windows.Forms.ITypedDataObject

Megjegyzések

Az IDataObject illesztőt az osztály és a Clipboard húzási műveletek használják.

Amikor egy osztályban implementálják, a IDataObject metódusok lehetővé teszik a felhasználó számára az adatok több formátumban történő tárolását az osztály egy példányában. Az adatok több formátumban történő tárolása növeli annak az esélyét, hogy egy célalkalmazás, amelynek formátumkövetelményei nem feltétlenül ismertek, lekérheti a tárolt adatokat. Az adatok egy példányban való IDataObjecttárolásához hívja meg a metódust SetData , és adja meg az adatformátumot a format paraméterben. Állítsa be a paramétert arra autoConvert az false esetre, ha nem szeretné, hogy a tárolt adatok más formátumba legyenek konvertálva a lekéréskor. Az adatok több formátumban való tárolásához többször is meghívható SetData egy példányon IDataObject .

A tárolt adatok lekéréséhez IDataObject hívja meg a GetData metódust, és adja meg a paraméter adatformátumát format . Állítsa be a paramétert autoConvert úgy, false hogy csak a megadott formátumban tárolt adatokat kérje le. Ha a tárolt adatokat a megadott formátumra szeretné konvertálni, állítsa be autoConverttrue, vagy ne használja autoConvert.

A tárolt IDataObjectadatok formátumának meghatározásához használja az alábbi IDataObject módszereket.

• Hívja meg a GetFormats metódust az összes olyan formátum tömbjének lekéréséhez, amelyben az adatok elérhetők. Állítsa be a autoConvert paramétert úgy, hogy false csak azokat a formátumokat kapja meg, amelyekben az adatok tárolása történik. Ha le szeretné kapni az összes formátumot, amelyben az adatok elérhetők, állítsa be autoConverttrue, vagy ne használja ezt a paramétert.

• Hívja meg a GetDataPresent metódust annak megállapításához, hogy a tárolt adatok elérhetők-e egy adott formátumban. Ha nem szeretné, hogy a tárolt adatok a megadott formátumra legyenek konvertálva, állítsa a paramétert a autoConvert következőre false: .

Tekintse meg az DataObject osztályt a felület implementálásához. Tekintse meg az DataFormats előre definiált adatformátumok osztályát Clipboard .

Metódusok

Name	Description
GetData(String, Boolean)	Lekéri a megadott adatformátumhoz társított adatokat logikai érték használatával annak meghatározásához, hogy az adatokat konvertálja-e formátummá.
GetData(String)	Lekéri a megadott adatformátumhoz társított adatokat.
GetData(Type)	Lekéri a megadott osztálytípus-formátumhoz társított adatokat.
GetDataPresent(String, Boolean)	Meghatározza, hogy az ebben a példányban tárolt adatok társítva legyenek-e a megadott formátummal, logikai érték használatával annak meghatározásához, hogy az adatok formátummá alakíthatók-e.
GetDataPresent(String)	Meghatározza, hogy az ebben a példányban tárolt adatok a megadott formátumhoz tartoznak-e vagy konvertálhatók-e.
GetDataPresent(Type)	Meghatározza, hogy az ebben a példányban tárolt adatok a megadott formátumhoz tartoznak-e vagy konvertálhatók-e.
GetFormats()	Azoknak a formátumoknak a listáját adja vissza, amelyekhez az ebben a példányban tárolt adatok társítva vagy konvertálhatók.
GetFormats(Boolean)	Lekéri azoknak a formátumoknak a listáját, amelyekhez az ebben a példányban tárolt adatok társítva vagy átalakíthatók logikai érték használatával annak megállapításához, hogy lekéri-e az összes olyan formátumot, amelybe az adatok konvertálhatók, vagy csak natív adatformátumokká.
SetData(Object)	A megadott adatokat ebben a példányban tárolja a formátumhoz tartozó adatosztály használatával.
SetData(String, Boolean, Object)	Ebben a példányban tárolja a megadott adatokat és a hozzájuk tartozó formátumot logikai érték használatával annak meghatározásához, hogy az adatok konvertálhatók-e másik formátumba.
SetData(String, Object)	Ebben a példányban tárolja a megadott adatokat és a hozzájuk tartozó formátumot.
SetData(Type, Object)	Ebben a példányban tárolja a megadott adatokat és a hozzá tartozó osztálytípust.

Bővítő metódusok

Name	Description
TryGetData<T>(IDataObject, String, Boolean, T)	Formátumfüggetlen mechanizmust biztosít az adatok átviteléhez.
TryGetData<T>(IDataObject, String, Func<TypeName,Type>, Boolean, T)	Formátumfüggetlen mechanizmust biztosít az adatok átviteléhez.
TryGetData<T>(IDataObject, String, T)	Formátumfüggetlen mechanizmust biztosít az adatok átviteléhez.
TryGetData<T>(IDataObject, T)	Formátumfüggetlen mechanizmust biztosít az adatok átviteléhez.

Lásd még

• DataObject
• DataFormats