Sdílet prostřednictvím


DataObject Třída

Definice

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

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
Dědičnost
DataObject
Implementuje

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

Důležité

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

Konstruktory

DataObject()

Inicializuje novou instanci DataObject třídy.

DataObject(Object)

Inicializuje novou instanci DataObject třídy, která obsahuje zadaná data.

DataObject(String, Object)

Inicializuje novou instanci DataObject třídy, která obsahuje zadaná data a jejich přidružený formát; formát je určen řetězcem.

DataObject(String, Object, Boolean)

Inicializuje novou instanci DataObject třídy, která obsahuje zadaná data a jejich přidružený formát; formát je určen řetězcem. Toto přetížení obsahuje Boolean příznak, který označuje, jestli mohou být data při načítání převedena do jiného formátu.

DataObject(Type, Object)

Inicializuje novou instanci DataObject třídy, která obsahuje zadaná data a jejich přidružený formát; datový formát je určen objektem Type .

Pole

CopyingEvent

Identifikuje připojenou Copying událost.

PastingEvent

Identifikuje připojenou Pasting událost.

SettingDataEvent

Identifikuje připojenou SettingData událost.

Metody

AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Přidá obslužnou rutinu Copying události do zadaného objektu závislostí.

AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)

Přidá obslužnou rutinu Pasting události do zadaného objektu závislostí.

AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Přidá obslužnou rutinu SettingData události do zadaného objektu závislostí.

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 ve formátu textových dat.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetAudioStream()

Vrátí datový proud, který obsahuje data ve WaveAudio formátu dat.

GetData(String)

Vrátí data ve formátu určeném řetězcem.

GetData(String, Boolean)

Vrátí datový objekt v zadaném formátu a volitelně převede data do zadaného formátu.

GetData(Type)

Vrátí datový objekt ve formátu určeném objektem Type .

GetDataPresent(String)

Určuje, zda jsou data k dispozici ve formátu určeném řetězcem nebo lze je převést na.

GetDataPresent(String, Boolean)

Určuje, zda jsou data k dispozici v zadaném formátu nebo zda je lze převést na. Příznak Boolean označuje, jestli se má zkontrolovat, jestli je možné data převést do zadaného formátu, pokud nejsou v daném formátu k dispozici.

GetDataPresent(Type)

Určuje, zda jsou data k dispozici ve formátu určeném objektem Type nebo lze je převést na.

GetFileDropList()

Vrátí kolekci řetězců, která obsahuje seznam vyřazených souborů.

GetFormats()

Vrátí seznam formátů, ve kterých jsou data v tomto datovém objektu uložena nebo lze je 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, zda se mají zahrnout také formáty, na které lze data automaticky převést.

GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
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.

GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

Odebere obslužnou rutinu Copying události ze zadaného objektu závislostí.

RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)

Odebere obslužnou rutinu Pasting události ze zadaného objektu závislostí.

RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

Odebere obslužnou rutinu SettingData události ze zadaného objektu závislostí.

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)

Ukládá zadaná data v tomto datovém objektu spolu s jedním nebo více zadanými datovými formáty; formát dat je určen řetězcem.

SetData(String, Object, Boolean)

Ukládá zadaná data v tomto datovém objektu spolu s jedním nebo více zadanými datovými formáty. Toto přetížení obsahuje Boolean příznak, který označuje, jestli je možné data při načítání převést do jiného formátu.

SetData(Type, Object)

Ukládá zadaná data v tomto datovém objektu spolu s jedním nebo více zadanými datovými formáty; formát dat je určen objektem Type .

SetFileDropList(StringCollection)

Ukládá FileDrop data v tomto datovém objektu. Seznam vyřazených souborů je určen jako kolekce řetězců.

SetImage(BitmapSource)

Ukládá Bitmap data v tomto datovém objektu. Data obrázku jsou zadána BitmapSourcejako .

SetText(String)

Ukládá UnicodeText data zadaná jako řetězec v tomto datovém objektu.

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 pomocí člena .TextDataFormat

ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Přidružené události

Copying

Nastane, když přidružený objekt závislosti připravil příslušné datové formáty, které představují výběr kopírování, přidal formáty výběru kopírování do objektu DataObjecta je připraven buď umístit DataObjectClipboard na nebo zahájit operaci přetažení.

Pasting

Nastane, když přidružený objekt závislosti je 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í

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

Vytvoří propojení mezi datovým objektem a jímkou poradce. Tuto metodu volá objekt, který podporuje jímku poradce a umožňuje jímce poradce upozornit na změny v datech objektu.

IDataObject.DUnadvise(Int32)

Zničí připojení oznámení, které bylo dříve navázáno.

IDataObject.EnumDAdvise(IEnumSTATDATA)

Vytvoří objekt, který lze použít k výčtu aktuálních poradce připojení.

IDataObject.EnumFormatEtc(DATADIR)

Vytvoří objekt pro výčet struktur datového objektu FORMATETC . 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. Tato metoda slouží k určení, zda dvě různé FORMATETC struktury vrátí stejná data, čímž se odstraní nutnost duplicitního vykreslování.

IDataObject.GetData(FORMATETC, STGMEDIUM)

Získá data ze zdrojového datového objektu. Metoda GetData(FORMATETC, STGMEDIUM) , kterou volá příjemce dat, vykreslí 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é paměťové médium.

IDataObject.QueryGetData(FORMATETC)

Určuje, zda datový objekt je schopen vykreslovat data popsaná ve struktuře FORMATETC . Objekty, které se pokoušejí o operaci vložení nebo přetažení, mohou před voláním GetData(FORMATETC, STGMEDIUM) volat tuto metodu, aby získaly indikaci, 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.

Platí pro

Viz také