TypeDescriptor Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

System.ComponentModel.TypeConverter.dll

Zdroj:

TypeDescriptor.cs

Poskytuje informace o vlastnostech komponenty, jako jsou jeho atributy, vlastnosti a události. Tuto třídu nelze zdědit.

public ref class TypeDescriptor sealed

public sealed class TypeDescriptor

type TypeDescriptor = class

Public NotInheritable Class TypeDescriptor

Dědičnost

Object

TypeDescriptor

Poznámky

Rozhraní .NET Framework poskytuje dva způsoby přístupu k metadatům typu: rozhraní API reflexe poskytované v oboru názvů System.Reflection a třída TypeDescriptor. Reflexe je obecný mechanismus dostupný pro všechny typy, protože jeho základ je vytvořen v GetType metody kořenové Object třídy. Informace, které vrací pro typ, nejsou rozšiřitelné, protože je nelze změnit po kompilaci cílového typu. Další informace naleznete v tématech v Reflexe.

Naproti tomu TypeDescriptor je rozšiřitelný kontrolní mechanismus pro komponenty: třídy, které implementují IComponent rozhraní. Na rozdíl od reflexe neprověřuje metody. TypeDescriptor lze dynamicky rozšířit několika službami dostupnými prostřednictvím Sitecílové komponenty . Následující tabulka uvádí tyto služby.

Název služby	Popis
IExtenderProvider	Umožňuje další třídu, například ToolTip, poskytnout další vlastnosti součásti.
ITypeDescriptorFilterService	Umožňuje jinému objektu upravit standardní metadata, která jsou vystavena komponentou.
ICustomTypeDescriptor	Umožňuje třídě zcela a dynamicky specifikovat vlastní metadata a nahradit standardní kontrolní mechanismus TypeDescriptor.

Rozšiřitelnost poskytovaná TypeDescriptor umožňuje znázornění komponenty v době návrhu se lišit od skutečné reprezentace za běhu, což TypeDescriptor užitečné pro vytváření infrastruktury návrhu.

Všechny metody v TypeDescriptor jsou static. Nelze vytvořit instanci této třídy a tato třída nemůže být zděděna.

Vlastnosti a hodnoty událostí můžete nastavit dvěma různými způsoby: určete je ve třídě komponenty nebo je v době návrhu změňte. Vzhledem k tomu, že tyto hodnoty můžete nastavit dvěma způsoby, přetížené metody TypeDescriptor mají dva různé typy parametrů: typ třídy nebo instanci objektu.

Pokud chcete získat přístup k informacím TypeDescriptor a máte instanci objektu, použijte metodu, která volá komponentu. Použijte metodu, která volá typ třídy pouze v případě, že nemáte instanci objektu.

Vlastnosti a události se ukládají do mezipaměti TypeDescriptor pro rychlost. Obvykle jsou konstantní po celou dobu života objektu. Poskytovatelé extenderu a návrháři však mohou změnit sadu vlastností objektu. Pokud se jedná o tento případ, musí být volána metoda Refresh pro aktualizaci mezipaměti.

Vlastnosti

ComNativeDescriptorHandler	Zastaralé. Získá nebo nastaví zprostředkovatele pro informace o typu modelu COM (Component Object Model) pro cílovou komponentu.
ComObjectType	Získá typ objektu COM (Component Object Model) reprezentovaný cílovou komponentou.
InterfaceType	Získá typ, který představuje typ popis zprostředkovatele pro všechny typy rozhraní.

Metody

AddAttributes(Object, Attribute[])	Přidá atributy na úrovni třídy do instance cílové komponenty.
AddAttributes(Type, Attribute[])	Přidá atributy na úrovni třídy do cílového typu komponenty.
AddEditorTable(Type, Hashtable)	Přidá tabulku editoru pro daný základní typ editoru.
AddProvider(TypeDescriptionProvider, Object)	Přidá zprostředkovatele popisu typu pro jednu instanci komponenty.
AddProvider(TypeDescriptionProvider, Type)	Přidá zprostředkovatele popisu typu pro třídu komponenty.
AddProviderTransparent(TypeDescriptionProvider, Object)	Přidá zprostředkovatele popisu typu pro jednu instanci komponenty.
AddProviderTransparent(TypeDescriptionProvider, Type)	Přidá zprostředkovatele popisu typu pro třídu komponenty.
CreateAssociation(Object, Object)	Vytvoří primární sekundární přidružení mezi dvěma objekty.
CreateDesigner(IComponent, Type)	Vytvoří instanci návrháře asociovaného se zadanou komponentou a zadaným typem návrháře.
CreateEvent(Type, EventDescriptor, Attribute[])	Vytvoří nový popisovač události, který je identický s existujícím popisovačem události, když předá existující EventDescriptor.
CreateEvent(Type, String, Type, Attribute[])	Vytvoří nový popisovač události, který je identický s existujícím popisovačem události dynamickým generováním informací popisovače ze zadané události typu.
CreateInstance(IServiceProvider, Type, Type[], Object[])	Vytvoří objekt, který může nahradit jiný datový typ.
CreateProperty(Type, PropertyDescriptor, Attribute[])	Vytvoří nový popisovač vlastnosti z existujícího popisovače vlastnosti pomocí zadaného existujícího PropertyDescriptor a pole atributů.
CreateProperty(Type, String, Type, Attribute[])	Vytvoří a dynamicky vytvoří popisovač vlastnosti na typ, pomocí zadaného názvu vlastnosti, typu a pole atributů.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetAssociation(Type, Object)	Vrátí instanci typu přidruženého k zadanému primárnímu objektu.
GetAttributes(Object)	Vrátí kolekci atributů pro zadanou komponentu.
GetAttributes(Object, Boolean)	Vrátí kolekci atributů pro zadanou komponentu a logickou hodnotu označující, že byl vytvořen popisovač vlastního typu.
GetAttributes(Type)	Vrátí kolekci atributů pro zadaný typ komponenty.
GetClassName(Object)	Vrátí název třídy pro zadanou komponentu pomocí výchozího popisovače typu.
GetClassName(Object, Boolean)	Vrátí název třídy pro zadanou komponentu pomocí popisovače vlastního typu.
GetClassName(Type)	Vrátí název třídy pro zadaný typ.
GetComponentName(Object)	Vrátí název zadané komponenty pomocí výchozího popisovače typu.
GetComponentName(Object, Boolean)	Vrátí název zadané komponenty pomocí vlastního popisovače typu.
GetConverter(Object)	Vrátí převaděč typů pro typ zadané komponenty.
GetConverter(Object, Boolean)	Vrátí převaděč typů pro typ zadané komponenty s vlastním popisovačem typu.
GetConverter(Type)	Vrátí převaděč typů pro zadaný typ.
GetDefaultEvent(Object)	Vrátí výchozí událost pro zadanou komponentu.
GetDefaultEvent(Object, Boolean)	Vrátí výchozí událost komponenty s popisovačem vlastního typu.
GetDefaultEvent(Type)	Vrátí výchozí událost pro zadaný typ komponenty.
GetDefaultProperty(Object)	Vrátí výchozí vlastnost pro zadanou komponentu.
GetDefaultProperty(Object, Boolean)	Vrátí výchozí vlastnost pro zadanou komponentu s popisovačem vlastního typu.
GetDefaultProperty(Type)	Vrátí výchozí vlastnost pro zadaný typ komponenty.
GetEditor(Object, Type)	Získá editor se zadaným základním typem pro zadanou komponentu.
GetEditor(Object, Type, Boolean)	Vrátí editor se zadaným základním typem a vlastním popisovačem typu pro zadanou komponentu.
GetEditor(Type, Type)	Vrátí editor se zadaným základním typem zadaného typu.
GetEvents(Object)	Vrátí kolekci událostí pro zadanou komponentu.
GetEvents(Object, Attribute[])	Vrátí kolekci událostí pro zadanou komponentu pomocí zadaného pole atributů jako filtru.
GetEvents(Object, Attribute[], Boolean)	Vrátí kolekci událostí pro zadanou komponentu pomocí zadaného pole atributů jako filtru a použití vlastního popisovače typu.
GetEvents(Object, Boolean)	Vrátí kolekci událostí pro zadanou komponentu s popisovačem vlastního typu.
GetEvents(Type)	Vrátí kolekci událostí pro zadaný typ komponenty.
GetEvents(Type, Attribute[])	Vrátí kolekci událostí pro zadaný typ komponenty pomocí zadaného pole atributů jako filtru.
GetFullComponentName(Object)	Vrátí plně kvalifikovaný název komponenty.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetProperties(Object)	Vrátí kolekci vlastností pro zadanou komponentu.
GetProperties(Object, Attribute[])	Vrátí kolekci vlastností pro zadanou komponentu pomocí zadaného pole atributů jako filtru.
GetProperties(Object, Attribute[], Boolean)	Vrátí kolekci vlastností pro zadanou komponentu pomocí zadaného pole atributů jako filtru a pomocí vlastního popisovače typu.
GetProperties(Object, Boolean)	Vrátí kolekci vlastností pro zadanou komponentu pomocí výchozího popisovače typu.
GetProperties(Type)	Vrátí kolekci vlastností pro zadaný typ komponenty.
GetProperties(Type, Attribute[])	Vrátí kolekci vlastností pro zadaný typ komponenty pomocí zadaného pole atributů jako filtru.
GetProvider(Object)	Vrátí zprostředkovatele popisu typu pro zadanou komponentu.
GetProvider(Type)	Vrátí zprostředkovatele popisu typu pro zadaný typ.
GetReflectionType(Object)	Vrátí Type, který lze použít k provedení reflexe vzhledem k objektu.
GetReflectionType(Type)	Vrátí Type, který lze použít k provedení reflexe vzhledem k typu třídy.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
Refresh(Assembly)	Vymaže vlastnosti a události zadaného sestavení z mezipaměti.
Refresh(Module)	Vymaže vlastnosti a události pro zadaný modul z mezipaměti.
Refresh(Object)	Vymaže vlastnosti a události pro zadanou komponentu z mezipaměti.
Refresh(Type)	Vymaže vlastnosti a události pro zadaný typ komponenty z mezipaměti.
RemoveAssociation(Object, Object)	Odebere přidružení mezi dvěma objekty.
RemoveAssociations(Object)	Odebere všechna přidružení primárního objektu.
RemoveProvider(TypeDescriptionProvider, Object)	Odebere dříve přidaného zprostředkovatele popisu typu, který je přidružený k zadanému objektu.
RemoveProvider(TypeDescriptionProvider, Type)	Odebere dříve přidaného zprostředkovatele popisu typu, který je přidružený k zadanému typu.
RemoveProviderTransparent(TypeDescriptionProvider, Object)	Odebere dříve přidaného zprostředkovatele popisu typu, který je přidružený k zadanému objektu.
RemoveProviderTransparent(TypeDescriptionProvider, Type)	Odebere dříve přidaného zprostředkovatele popisu typu, který je přidružený k zadanému typu.
SortDescriptorArray(IList)	Seřadí popisovače pomocí názvu popisovače.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

Refreshed

Nastane, když je mezipaměť pro komponentu vymazána.

Viz také

• EventDescriptor
• PropertyDescriptor
• System.Reflection
• IComponent
• ISite
• Přehled popisovače typů
• reflexe