DataObject Osztály

Definíció

Névtér:

System.Windows

Szerelvény:

PresentationCore.dll

A felület alapszintű implementációját IDataObject biztosítja, amely egy formátumfüggetlen mechanizmust határoz meg az adatok átviteléhez.

public ref class DataObject sealed : System::Runtime::InteropServices::ComTypes::IDataObject, System::Windows::ITypedDataObject

public sealed class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.ITypedDataObject

type DataObject = class
    interface IDataObject
    interface IDataObject
    interface ITypedDataObject

Public NotInheritable Class DataObject
Implements IDataObject, ITypedDataObject

Öröklődés

Object

DataObject

Megvalósítás

IDataObject IDataObject ITypedDataObject

Példák

Az alábbi példa bemutatja, hogyan használhatja ezt az osztályt.

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)

Megjegyzések

Important

Az osztályból származó metódusok nem megbízható adatokkal való meghívása biztonsági kockázatot jelent. Csak megbízható adatokkal hívja meg ennek az osztálynak a metódusait. További információ: Minden bemenet ellenőrzése.

Konstruktorok

Name	Description
DataObject()	Inicializálja a DataObject osztály új példányát.
DataObject(Object)	Inicializálja a DataObject megadott adatokat tartalmazó osztály új példányát.
DataObject(String, Object, Boolean)	Inicializálja a DataObject megadott adatokat és a hozzá tartozó formátumot tartalmazó osztály új példányát; a formátumot egy sztring adja meg. Ez a túlterhelés egy jelzőt Boolean tartalmaz, amely jelzi, hogy az adatok konvertálhatók-e más formátumba a lekérés során.
DataObject(String, Object)	Inicializálja a DataObject megadott adatokat és a hozzá tartozó formátumot tartalmazó osztály új példányát; a formátumot egy sztring adja meg.
DataObject(Type, Object)	Inicializálja az DataObject osztály új példányát, amely a megadott adatokat és a hozzá tartozó formátumot tartalmazza; az adatformátumot egy Type objektum adja meg.

Mezők

Name	Description
CopyingEvent	Azonosítja a Copying csatolt eseményt.
PastingEvent	Azonosítja a Pasting csatolt eseményt.
SettingDataEvent	Azonosítja a SettingData csatolt eseményt.

Metódusok

Name	Description
AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Eseménykezelőt Copying ad hozzá egy megadott függőségi objektumhoz.
AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)	Eseménykezelőt Pasting ad hozzá egy megadott függőségi objektumhoz.
AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Eseménykezelőt SettingData ad hozzá egy megadott függőségi objektumhoz.
ContainsAudio()	Lekérdez egy adatobjektumot az adatok adatformátumban WaveAudio való jelenlétére vonatkozóan.
ContainsFileDropList()	Lekérdez egy adatobjektumot az adatok adatformátumban FileDrop való jelenlétére vonatkozóan.
ContainsImage()	Lekérdez egy adatobjektumot az adatok adatformátumban Bitmap való jelenlétére vonatkozóan.
ContainsText()	Lekérdez egy adatobjektumot az adatok formátumbeli UnicodeText jelenlétére vonatkozóan.
ContainsText(TextDataFormat)	Lekérdez egy adatobjektumot az adatok szöveges adatformátumban való jelenlétére vonatkozóan.
GetAudioStream()	Adatformátumú WaveAudio adatokat tartalmazó adatfolyamot ad vissza.
GetData(String, Boolean)	Adott formátumú adatobjektumot ad vissza, opcionálisan átalakítva az adatokat a megadott formátumra.
GetData(String)	Sztring által megadott formátumban adja vissza az adatokat.
GetData(Type)	Egy objektum által Type megadott formátumú adatobjektumot ad vissza.
GetDataPresent(String, Boolean)	Meghatározza, hogy az adatok elérhetőek-e, vagy konvertálhatók-e egy megadott formátumban. A Boolean jelölő jelzi, hogy az adatok konvertálhatók-e a megadott formátumra, ha nem érhetők el ebben a formátumban.
GetDataPresent(String)	Meghatározza, hogy az adatok elérhetők-e egy sztring által megadott formátumban, vagy átalakíthatók-e.
GetDataPresent(Type)	Meghatározza, hogy az adatok elérhetők-e vagy átalakíthatók-e egy Type objektum által megadott formátumban.
GetFileDropList()	Visszaad egy sztringgyűjteményt, amely az elvetett fájlok listáját tartalmazza.
GetFormats()	Visszaadja azoknak a formátumoknak a listáját, amelyekben az adatobjektum adatai tárolhatók vagy átalakíthatók.
GetFormats(Boolean)	Visszaadja azoknak a formátumoknak a listáját, amelyekben az adatobjektumban lévő adatok tárolása történik. A Boolean jelölő azt jelzi, hogy az adatok automatikusan konvertálhatók-e formátumokat is.
GetImage()	Olyan objektumot ad BitmapSource vissza, amely a Bitmap formátumban lévő adatokat tartalmazza.
GetText()	Egy sztringet ad vissza, amely az UnicodeText adatobjektumban lévő adatokat tartalmazza.
GetText(TextDataFormat)	Az adatobjektumban megadott formátumú szöveges adatokat tartalmazó sztringet ad vissza.
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Eltávolít egy eseménykezelőt Copying egy megadott függőségi objektumból.
RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)	Eltávolít egy eseménykezelőt Pasting egy megadott függőségi objektumból.
RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Eltávolít egy eseménykezelőt SettingData egy megadott függőségi objektumból.
SetAudio(Byte[])	Ebben az adatobjektumban tárolja a hangadatokat (WaveAudio adatformátumot). A hangadatok bájttömbként lesznek megadva.
SetAudio(Stream)	Ebben az adatobjektumban tárolja a hangadatokat (WaveAudio adatformátumot). A hangadatok streamként lesznek megadva.
SetData(Object)	Ebben az adatobjektumban tárolja a megadott adatokat, és automatikusan meghatározza a forrásobjektum típusának adatformátumát.
SetData(String, Object, Boolean)	A megadott adatokat ebben az adatobjektumban tárolja egy vagy több megadott adatformátummal együtt. Ez a túlterhelés egy jelzőt Boolean tartalmaz, amely jelzi, hogy az adatok konvertálhatók-e más formátumba a lekérés során.
SetData(String, Object)	A megadott adatokat ebben az adatobjektumban tárolja egy vagy több megadott adatformátummal együtt; az adatformátumot egy sztring adja meg.
SetData(Type, Object)	A megadott adatokat ebben az adatobjektumban tárolja egy vagy több megadott adatformátummal együtt; az adatformátumot egy Type objektum adja meg.
SetDataAsJson<T>(String, T)	A felület alapszintű implementációját IDataObject biztosítja, amely egy formátumfüggetlen mechanizmust határoz meg az adatok átviteléhez.
SetDataAsJson<T>(T)	A felület alapszintű implementációját IDataObject biztosítja, amely egy formátumfüggetlen mechanizmust határoz meg az adatok átviteléhez.
SetFileDropList(StringCollection)	Ebben az adatobjektumban tárolja FileDrop az adatokat. Az elvetett fájllista sztringgyűjteményként van megadva.
SetImage(BitmapSource)	Ebben az adatobjektumban tárolja Bitmap az adatokat. A rendszerképadatok a következőként lesznek BitmapSourcemegadva: .
SetText(String, TextDataFormat)	Ebben az adatobjektumban tárolja a szöveges adatokat. Az tárolandó szöveges adatok formátuma a következő taggal TextDataFormatvan megadva:
SetText(String)	Ebben az adatobjektumban sztringként megadott adatokat tárol UnicodeText .
TryGetData<T>(String, Boolean, T)	A felület alapszintű implementációját IDataObject biztosítja, amely egy formátumfüggetlen mechanizmust határoz meg az adatok átviteléhez.
TryGetData<T>(String, Func<TypeName,Type>, Boolean, T)	A felület alapszintű implementációját IDataObject biztosítja, amely egy formátumfüggetlen mechanizmust határoz meg az adatok átviteléhez.
TryGetData<T>(String, T)	A felület alapszintű implementációját IDataObject biztosítja, amely egy formátumfüggetlen mechanizmust határoz meg az adatok átviteléhez.
TryGetData<T>(T)	A felület alapszintű implementációját IDataObject biztosítja, amely egy formátumfüggetlen mechanizmust határoz meg az adatok átviteléhez.

Hozzácsatolt események

Name	Description
Copying	Ez akkor fordul elő, ha a társított függőségi objektum megfelelő adatformátumokat készített, amelyek a másolási kijelölést jelölik, hozzáadta a másolási kijelölési formátumokat egy DataObjectfájlhoz, és készen áll arra, hogy a DataObjectClipboard másolási műveletet helyezze vagy kezdje el.
Pasting	Akkor fordul elő, ha a társított függőségi objektum készen áll az adatok beillesztésére.
SettingData	Akkor fordul elő, ha a társított függőségi objektum új adatformátumot próbál hozzáadni egy DataObject.

Explicit interfész-implementációk

Name	Description
IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)	Kapcsolatot hoz létre egy adatobjektum és egy tanácsadó fogadó között. Ezt a metódust egy olyan objektum hívja meg, amely támogatja a tanácsadó fogadót, és lehetővé teszi, hogy a tanácsadó fogadó értesüljön az objektum adatainak változásairól.
IDataObject.DUnadvise(Int32)	Megsemmisít egy korábban létrehozott értesítési kapcsolatot.
IDataObject.EnumDAdvise(IEnumSTATDATA)	Létrehoz egy objektumot, amely az aktuális tanácsadói kapcsolatok számbavételére használható.
IDataObject.EnumFormatEtc(DATADIR)	Létrehoz egy objektumot egy adatobjektum struktúráinak FORMATETC számbavételéhez. Ezeket a struktúrákat a rendszer a hívásban GetData(FORMATETC, STGMEDIUM)SetData(FORMATETC, STGMEDIUM, Boolean)vagy a .
IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)	Olyan standard FORMATETC struktúrát biztosít, amely logikailag egyenértékű egy összetettebb struktúrával. Ezzel a módszerrel megállapíthatja, hogy két különböző FORMATETC struktúra ugyanazokat az adatokat adja-e vissza, így nincs szükség duplikált renderelésre.
IDataObject.GetData(FORMATETC, STGMEDIUM)	Adatokat kér le egy forrásadat-objektumból. Az GetData(FORMATETC, STGMEDIUM) adatfelhasználó által meghívott metódus a megadott FORMATETC struktúrában leírt adatokat rendereli, és a megadott STGMEDIUM struktúrán keresztül továbbítja. A hívó ezután felelősséget vállal a struktúra felszabadításáért STGMEDIUM .
IDataObject.GetDataHere(FORMATETC, STGMEDIUM)	Adatokat kér le egy forrásadat-objektumból. Ez az adatfogyó által hívott metódus abban különbözik a GetData(FORMATETC, STGMEDIUM) metódustól, hogy a hívónak ki kell osztania és felszabadítania a megadott tárolóeszközt.
IDataObject.QueryGetData(FORMATETC)	Meghatározza, hogy az adatobjektum képes-e renderelni a struktúrában FORMATETC leírt adatokat. A beillesztési vagy ledobási műveletet megkísérlõ objektumok meghívhatják ezt a metódust, mielőtt meghívják GetData(FORMATETC, STGMEDIUM) , hogy jelezve legyen, hogy a művelet sikeres lehet-e.
IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)	Adatokat továbbít a metódust megvalósító objektumnak. Ezt a metódust egy adatforrást tartalmazó objektum hívja meg.

Bővítő metódusok

Name	Description
TryGetData<T>(IDataObject, String, Boolean, T)	A felület alapszintű implementációját IDataObject biztosítja, amely egy formátumfüggetlen mechanizmust határoz meg az adatok átviteléhez.
TryGetData<T>(IDataObject, String, Func<TypeName,Type>, Boolean, T)	A felület alapszintű implementációját IDataObject biztosítja, amely egy formátumfüggetlen mechanizmust határoz meg az adatok átviteléhez.
TryGetData<T>(IDataObject, String, T)	A felület alapszintű implementációját IDataObject biztosítja, amely egy formátumfüggetlen mechanizmust határoz meg az adatok átviteléhez.
TryGetData<T>(IDataObject, T)	A felület alapszintű implementációját IDataObject biztosítja, amely egy formátumfüggetlen mechanizmust határoz meg az adatok átviteléhez.

Lásd még

• Elvetett fájlminta betöltése