TypeDescriptor Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

netstandard.dll, 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řídu TypeDescriptor. Reflexe je obecný mechanismus dostupný pro všechny typy, protože jeho základ je vytvořen v GetType metodě 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 najdete v tématech v reflexi.

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 cílové komponenty Site. 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 komponentě.
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, kterou TypeDescriptor poskytuje, umožňuje znázornění komponenty v době návrhu se lišit od skutečné reprezentace za běhu, což je TypeDescriptor užitečné pro vytváření infrastruktury návrhu.

Všechny metody jsou TypeDescriptorstatic. 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 TypeDescriptor informacím 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 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í Refresh být volána metoda pro aktualizaci mezipaměti.

Vlastnosti

Name	Description
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

Name	Description
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 při předání existujícího EventDescriptorpopisovače .
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 vlastností pomocí zadaného existujícího PropertyDescriptor pole 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, Boolean)	Vrátí kolekci atributů pro zadanou komponentu a logickou hodnotu označující, že byl vytvořen popisovač vlastního typu.
GetAttributes(Object)	Vrátí kolekci atributů pro zadanou komponentu.
GetAttributes(Type)	Vrátí kolekci atributů pro zadaný typ komponenty.
GetClassName(Object, Boolean)	Vrátí název třídy pro zadanou komponentu pomocí popisovače vlastního typu.
GetClassName(Object)	Vrátí název třídy pro zadanou komponentu pomocí výchozího popisovače typu.
GetClassName(Type)	Vrátí název třídy pro zadaný typ.
GetComponentName(Object, Boolean)	Vrátí název zadané komponenty pomocí vlastního popisovače typu.
GetComponentName(Object)	Vrátí název zadané komponenty pomocí výchozího popisovače typu.
GetConverter(Object, Boolean)	Vrátí převaděč typů pro typ zadané komponenty s vlastním popisovačem typu.
GetConverter(Object)	Vrátí převaděč typů pro typ zadané komponenty.
GetConverter(Type)	Vrátí převaděč typů pro zadaný typ.
GetConverterFromRegisteredType(Object)	Získá převaděč typů pro typ zadané komponenty.
GetConverterFromRegisteredType(Type)	Získá převaděč typů pro zadaný registrovaný typ.
GetDefaultEvent(Object, Boolean)	Vrátí výchozí událost komponenty s popisovačem vlastního typu.
GetDefaultEvent(Object)	Vrátí výchozí událost pro zadanou komponentu.
GetDefaultEvent(Type)	Vrátí výchozí událost pro zadaný typ komponenty.
GetDefaultProperty(Object, Boolean)	Vrátí výchozí vlastnost pro zadanou komponentu s popisovačem vlastního typu.
GetDefaultProperty(Object)	Vrátí výchozí vlastnost pro zadanou komponentu.
GetDefaultProperty(Type)	Vrátí výchozí vlastnost pro zadaný typ komponenty.
GetEditor(Object, Type, Boolean)	Vrátí editor se zadaným základním typem a vlastním popisovačem typu pro zadanou komponentu.
GetEditor(Object, Type)	Získá editor se zadaným základním typem pro zadanou komponentu.
GetEditor(Type, Type)	Vrátí editor se zadaným základním typem zadaného typu.
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, Attribute[])	Vrátí kolekci událostí pro zadanou komponentu pomocí zadaného pole atributů jako filtru.
GetEvents(Object, Boolean)	Vrátí kolekci událostí pro zadanou komponentu s popisovačem vlastního typu.
GetEvents(Object)	Vrátí kolekci událostí pro zadanou komponentu.
GetEvents(Type, Attribute[])	Vrátí kolekci událostí pro zadaný typ komponenty pomocí zadaného pole atributů jako filtru.
GetEvents(Type)	Vrátí kolekci událostí pro zadaný typ komponenty.
GetEventsFromRegisteredType(Type)	Získá kolekci událostí pro zadaný typ komponenty.
GetFullComponentName(Object)	Vrátí plně kvalifikovaný název komponenty.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
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, Attribute[])	Vrátí kolekci vlastností pro zadanou komponentu pomocí zadaného pole atributů jako filtru.
GetProperties(Object, Boolean)	Vrátí kolekci vlastností pro zadanou komponentu pomocí výchozího popisovače typu.
GetProperties(Object)	Vrátí kolekci vlastností pro zadanou komponentu.
GetProperties(Type, Attribute[])	Vrátí kolekci vlastností pro zadaný typ komponenty pomocí zadaného pole atributů jako filtru.
GetProperties(Type)	Vrátí kolekci vlastností pro zadaný typ komponenty.
GetPropertiesFromRegisteredType(Object)	Získá kolekci vlastností pro zadanou komponentu.
GetPropertiesFromRegisteredType(Type)	Získá kolekci vlastností pro zadaný typ.
GetProvider(Object)	Vrátí zprostředkovatele popisu typu pro zadanou komponentu.
GetProvider(Type)	Vrátí zprostředkovatele popisu typu pro zadaný typ.
GetReflectionType(Object)	Type Vrátí objekt, který lze použít k provedení reflexe.
GetReflectionType(Type)	Type Vrátí hodnotu, kterou lze použít k reflexi 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.
RegisterType<T>()	Zaregistruje typ, aby ho mohli používat poskytovatelé založené na reflexi v oříznutých aplikacích.
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

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

Viz také

• EventDescriptor
• PropertyDescriptor
• System.Reflection
• IComponent
• ISite
• Úvaha