IDataObject Rozhraní

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

IDataObject.cs

Poskytuje mechanismus nezávislý na formátu pro přenos dat.

public interface class IDataObject

public interface IDataObject

type IDataObject = interface

Public Interface IDataObject

Odvozené

System.Windows.Forms.DataObject

System.Windows.Forms.ITypedDataObject

Poznámky

Rozhraní IDataObject je používáno Clipboard třídou a v operacích přetažení.

Při implementaci ve třídě IDataObject umožňují uživatelům ukládat data ve více formátech v instanci třídy. Ukládání dat ve více než jednom formátu zvyšuje pravděpodobnost, že cílová aplikace, jejíž požadavky na formát možná neznáte, může načíst uložená data. Chcete-li uložit data v instanci IDataObject, zavolejte metodu SetData a zadejte formát dat v parametru format . autoConvert Pokud nechcete, aby se uložená data při načítání převedli do jiného formátu, nastavte parametr na false hodnotu. Vyvolání SetData vícekrát v jedné instanci IDataObject pro ukládání dat ve více než jednom formátu.

Uložená IDataObject data načtete voláním GetData metody a zadáním formátu dat v parametru format . autoConvert Nastavte parametr tak, aby false načítal pouze data uložená v zadaném formátu. Chcete-li převést uložená data do zadaného formátu, nastavte autoConvert hodnotu truenebo nepoužívejte autoConvert.

Chcete-li určit formáty dat uložených v aplikaci IDataObject, použijte následující IDataObject metody.

• GetFormats Voláním metody načtěte pole všech formátů, ve kterých jsou data k dispozici. autoConvert Nastavte parametr tak, aby false se načíst pouze formáty, ve kterých jsou data uložena. Chcete-li získat všechny formáty, ve kterých jsou data k dispozici, nastavte autoConvert na truehodnotu nebo nepoužívejte tento parametr.

• GetDataPresent Voláním metody určete, zda jsou uložená data k dispozici v určitém formátu. Pokud nechcete, aby uložená data byla převedena do zadaného formátu, nastavte autoConvert parametr na false.

Podívejte se na DataObject třídu pro implementaci tohoto rozhraní. DataFormats Viz třída pro předdefinované Clipboard formáty dat.

Metody

Name	Description
GetData(String, Boolean)	Načte data přidružená k zadanému formátu dat pomocí logické hodnoty k určení, zda se mají data převést do formátu.
GetData(String)	Načte data přidružená k zadanému formátu dat.
GetData(Type)	Načte data přidružená k zadanému formátu typu třídy.
GetDataPresent(String, Boolean)	Určuje, zda jsou data uložená v této instanci přidružena k zadanému formátu pomocí logické hodnoty k určení, zda se mají data převést do formátu.
GetDataPresent(String)	Určuje, zda jsou data uložená v této instanci přidružena nebo lze převést na zadaný formát.
GetDataPresent(Type)	Určuje, zda jsou data uložená v této instanci přidružena nebo lze převést na zadaný formát.
GetFormats()	Vrátí seznam všech formátů, ke kterým jsou data uložená v této instanci přidružena nebo na které lze převést.
GetFormats(Boolean)	Získá seznam všech formátů, které data uložená v této instanci jsou přidruženy nebo lze převést na, pomocí logické hodnoty určit, zda se mají načíst všechny formáty, které lze data převést do nebo pouze nativní datové formáty.
SetData(Object)	Uloží zadaná data v této instanci pomocí třídy dat pro formát.
SetData(String, Boolean, Object)	Uloží zadaná data a přidružený formát v této instanci pomocí logické hodnoty k určení, zda lze data převést do jiného formátu.
SetData(String, Object)	Uloží zadaná data a přidružený formát v této instanci.
SetData(Type, Object)	Uloží zadaná data a jeho přidružený typ třídy v této instanci.

Metody rozšíření

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

Viz také

• DataObject
• DataFormats