DataObject Třída

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationCore.dll

Poskytuje základní implementaci IDataObject rozhraní, která definuje mechanismus nezávislý na formátu pro přenos dat.

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

Dědičnost

Object

DataObject

Implementuje

IDataObject IDataObject ITypedDataObject

Příklady

Následující příklad ukazuje, jak používat tuto třídu.

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)

Poznámky

Important

Volání metod z této třídy s nedůvěryhodnými daty představuje bezpečnostní riziko. Volejte metody z této třídy pouze s důvěryhodnými daty. Další informace naleznete v tématu Ověření všech vstupů.

Konstruktory

Name	Description
DataObject()	Inicializuje novou instanci DataObject třídy.
DataObject(Object)	Inicializuje novou instanci DataObject třídy, která obsahuje zadaná data.
DataObject(String, Object, Boolean)	Inicializuje novou instanci DataObject třídy, která obsahuje zadaná data a jeho přidružený formát; formát je určen řetězcem. Toto přetížení obsahuje příznak, Boolean který označuje, zda mohou být data při načítání převedena do jiného formátu.
DataObject(String, Object)	Inicializuje novou instanci DataObject třídy, která obsahuje zadaná data a jeho přidružený formát; formát je určen řetězcem.
DataObject(Type, Object)	Inicializuje novou instanci DataObject třídy, která obsahuje zadaná data a jeho přidružený formát; datový formát je určen objektem Type .

Pole

Name	Description
CopyingEvent	Identifikuje připojenou Copying událost.
PastingEvent	Identifikuje připojenou Pasting událost.
SettingDataEvent	Identifikuje připojenou SettingData událost.

Metody

Name	Description
AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Přidá obslužnou rutinu Copying události do zadaného objektu závislosti.
AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)	Přidá obslužnou rutinu Pasting události do zadaného objektu závislosti.
AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Přidá obslužnou rutinu SettingData události do zadaného objektu závislosti.
ContainsAudio()	Dotazuje datový objekt na přítomnost dat ve WaveAudio formátu dat.
ContainsFileDropList()	Dotazuje datový objekt na přítomnost dat ve FileDrop formátu dat.
ContainsImage()	Dotazuje datový objekt na přítomnost dat ve Bitmap formátu dat.
ContainsText()	Dotazuje datový objekt na přítomnost dat ve UnicodeText formátu.
ContainsText(TextDataFormat)	Dotazuje datový objekt na přítomnost dat v textovém datovém formátu.
GetAudioStream()	Vrátí datový proud, který obsahuje data ve WaveAudio formátu dat.
GetData(String, Boolean)	Vrátí datový objekt v zadaném formátu, volitelně převede data do zadaného formátu.
GetData(String)	Vrátí data ve formátu určeném řetězcem.
GetData(Type)	Vrátí datový objekt ve formátu určeném objektem Type .
GetDataPresent(String, Boolean)	Určuje, zda jsou data k dispozici v zadaném formátu nebo lze je převést na zadaný formát. Příznak Boolean označuje, zda chcete zkontrolovat, zda lze data převést do zadaného formátu, pokud není v tomto formátu k dispozici.
GetDataPresent(String)	Určuje, zda jsou data k dispozici nebo lze převést na formát určený řetězcem.
GetDataPresent(Type)	Určuje, zda jsou data k dispozici nebo lze převést na formát určený objektem Type .
GetFileDropList()	Vrátí kolekci řetězců, která obsahuje seznam vyřazených souborů.
GetFormats()	Vrátí seznam formátů, ve kterých jsou uložena data v tomto datovém objektu, nebo lze převést na.
GetFormats(Boolean)	Vrátí seznam formátů, ve kterých jsou uložena data v tomto datovém objektu. Příznak Boolean označuje, jestli se mají zahrnout i formáty, na které lze data automaticky převést.
GetImage()	BitmapSource Vrátí objekt, který obsahuje data ve Bitmap formátu.
GetText()	Vrátí řetězec, který obsahuje UnicodeText data v tomto datovém objektu.
GetText(TextDataFormat)	Vrátí řetězec, který obsahuje textová data zadaného formátu v tomto datovém objektu.
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Odebere obslužnou rutinu Copying události ze zadaného objektu závislosti.
RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)	Odebere obslužnou rutinu Pasting události ze zadaného objektu závislosti.
RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Odebere obslužnou rutinu SettingData události ze zadaného objektu závislosti.
SetAudio(Byte[])	Ukládá zvuková data (WaveAudio formát dat) v tomto datovém objektu. Zvuková data jsou určena jako pole bajtů.
SetAudio(Stream)	Ukládá zvuková data (WaveAudio formát dat) v tomto datovém objektu. Zvuková data se zadává jako datový proud.
SetData(Object)	Uloží zadaná data v tomto datovém objektu a automaticky určí formát dat ze zdrojového typu objektu.
SetData(String, Object, Boolean)	Uloží zadaná data v tomto datovém objektu spolu s jedním nebo více zadanými formáty dat. Toto přetížení obsahuje Boolean příznak, který označuje, zda lze data při načítání převést do jiného formátu.
SetData(String, Object)	Ukládá zadaná data v tomto datovém objektu spolu s jedním nebo více zadanými formáty dat; Formát dat je určen řetězcem.
SetData(Type, Object)	Ukládá zadaná data v tomto datovém objektu spolu s jedním nebo více zadanými formáty dat; datový formát je určen objektem Type .
SetDataAsJson<T>(String, T)	Poskytuje základní implementaci IDataObject rozhraní, která definuje mechanismus nezávislý na formátu pro přenos dat.
SetDataAsJson<T>(T)	Poskytuje základní implementaci IDataObject rozhraní, která definuje mechanismus nezávislý na formátu pro přenos dat.
SetFileDropList(StringCollection)	Ukládá FileDrop data v tomto datovém objektu. Vyřazený seznam souborů je určen jako kolekce řetězců.
SetImage(BitmapSource)	Ukládá Bitmap data v tomto datovém objektu. Data obrázku jsou určena jako BitmapSource.
SetText(String, TextDataFormat)	Ukládá textová data v tomto datovém objektu. Formát textových dat, která se mají uložit, je určen členem .TextDataFormat
SetText(String)	Ukládá UnicodeText data zadaná jako řetězec v tomto datovém objektu.
TryGetData<T>(String, Boolean, T)	Poskytuje základní implementaci IDataObject rozhraní, která definuje mechanismus nezávislý na formátu pro přenos dat.
TryGetData<T>(String, Func<TypeName,Type>, Boolean, T)	Poskytuje základní implementaci IDataObject rozhraní, která definuje mechanismus nezávislý na formátu pro přenos dat.
TryGetData<T>(String, T)	Poskytuje základní implementaci IDataObject rozhraní, která definuje mechanismus nezávislý na formátu pro přenos dat.
TryGetData<T>(T)	Poskytuje základní implementaci IDataObject rozhraní, která definuje mechanismus nezávislý na formátu pro přenos dat.

Přidružené události

Name	Description
Copying	Nastane, když přidružený objekt závislosti připravil vhodné formáty dat, které představují výběr kopírování, přidání formátů výběru kopírování do objektu DataObjecta je připraven buď umístit na DataObjectClipboard nebo zahájit operaci přetažení.
Pasting	Nastane, když je přidružený objekt závislosti připravený k vložení dat.
SettingData	Nastane, když se přidružený objekt závislosti pokusí přidat nový datový formát do objektu DataObject.

Explicitní implementace rozhraní

Name	Description
IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)	Vytvoří propojení mezi datovým objektem a jímkou rady. Tato metoda je volána objektem, který podporuje jímku poradenství a umožňuje jímce rady dostávat oznámení o změnách v datech objektu.
IDataObject.DUnadvise(Int32)	Zničí připojení oznámení, které bylo dříve vytvořeno.
IDataObject.EnumDAdvise(IEnumSTATDATA)	Vytvoří objekt, který lze použít k vytvoření výčtu aktuálních připojení poradce.
IDataObject.EnumFormatEtc(DATADIR)	Vytvoří objekt pro vytvoření výčtu FORMATETC struktur datového objektu. Tyto struktury se používají ve voláních nebo GetData(FORMATETC, STGMEDIUM)SetData(FORMATETC, STGMEDIUM, Boolean).
IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)	Poskytuje standardní FORMATETC strukturu, která je logicky ekvivalentní složitější struktuře. Tuto metodu použijte k určení, jestli by dvě různé FORMATETC struktury vrátily stejná data, a proto je potřeba duplikovat vykreslování.
IDataObject.GetData(FORMATETC, STGMEDIUM)	Získá data ze zdrojového datového objektu. Metoda GetData(FORMATETC, STGMEDIUM) , která je volána příjemcem dat, vykresluje data popsaná v zadané FORMATETC struktuře a přenese je přes zadanou STGMEDIUM strukturu. Volající pak převezme odpovědnost za uvolnění STGMEDIUM struktury.
IDataObject.GetDataHere(FORMATETC, STGMEDIUM)	Získá data ze zdrojového datového objektu. Tato metoda, která je volána příjemcem dat, se liší od GetData(FORMATETC, STGMEDIUM) metody v tom, že volající musí přidělit a uvolnit zadané médium úložiště.
IDataObject.QueryGetData(FORMATETC)	Určuje, zda je datový objekt schopen vykreslovat data popsaná ve struktuře FORMATETC . Objekty, které se pokoušejí o operaci vložení nebo odstranění, mohou tuto metodu volat před voláním GetData(FORMATETC, STGMEDIUM) , aby získaly informace o tom, zda operace může být úspěšná.
IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)	Přenáší data do objektu, který implementuje tuto metodu. Tato metoda je volána objektem, který obsahuje zdroj dat.

Metody rozšíření

Name	Description
TryGetData<T>(IDataObject, String, Boolean, T)	Poskytuje základní implementaci IDataObject rozhraní, která definuje mechanismus nezávislý na formátu pro přenos dat.
TryGetData<T>(IDataObject, String, Func<TypeName,Type>, Boolean, T)	Poskytuje základní implementaci IDataObject rozhraní, která definuje mechanismus nezávislý na formátu pro přenos dat.
TryGetData<T>(IDataObject, String, T)	Poskytuje základní implementaci IDataObject rozhraní, která definuje mechanismus nezávislý na formátu pro přenos dat.
TryGetData<T>(IDataObject, T)	Poskytuje základní implementaci IDataObject rozhraní, která definuje mechanismus nezávislý na formátu pro přenos dat.

Viz také

• Načtení ukázky vyřazeného souboru