TypeDescriptor Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

System.ComponentModel.TypeConverter.dll

Zdroj:

TypeDescriptor.cs

Poskytuje informace o vlastnostech komponenty, jako jsou její atributy, vlastnosti a události. Tuto třídu nelze dě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 System.Reflection oboru názvů a TypeDescriptor třídu . 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é pro typ vrací, nejsou rozšiřitelné, protože je nelze po kompilaci cílového typu upravit. Další informace najdete v tématech v tématu Reflexe.

Naproti tomu TypeDescriptor je rozšiřitelný kontrolní mechanismus pro komponenty: ty třídy, které implementují IComponent rozhraní. Na rozdíl od reflexe nekontroluje metody. TypeDescriptor lze dynamicky rozšířit několika službami dostupnými prostřednictvím cílové komponenty Site. Tyto služby jsou uvedeny v následující tabulce.

Název služby	Popis
IExtenderProvider	Umožňuje jiné třídě, jako ToolTipje , poskytovat další vlastnosti komponentě.
ITypeDescriptorFilterService	Umožňuje jinému objektu upravit standardní metadata, která jsou zpřístupněna komponentou.
ICustomTypeDescriptor	Umožňuje třídě zcela a dynamicky specifikovat vlastní metadata, čímž nahradí standardní kontrolní mechanismus .TypeDescriptor

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

Všechny metody v souboru TypeDescriptor jsou static. Nelze vytvořit instanci této třídy a tuto třídu nelze dědit.

Hodnoty vlastností a událostí můžete nastavit dvěma různými způsoby: zadat je ve třídě komponenty nebo je změnit v době návrhu. Protože tyto hodnoty můžete nastavit dvěma způsoby, přetížené metody TypeDescriptor metody přebírají 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 kvůli rychlosti ukládají TypeDescriptor do mezipaměti. Obvykle jsou konstantní po dobu životnosti objektu. Zprostředkovatelé rozšíření a návrháři však mohou změnit sadu vlastností objektu. Pokud se jedná o tento případ, Refresh musí být volána metoda 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 modelu COM (Component Object Model) reprezentované cílovou komponentou.
InterfaceType	Získá typ, který představuje zprostředkovatele popisu typu 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 přidruženého k zadané komponentě a zadaného typu návrháře.
CreateEvent(Type, EventDescriptor, Attribute[])	Při předání existujícího EventDescriptorpopisovače události vytvoří nový popisovač události, který je shodný s existujícím popisovačem události.
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 na 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ří vazbu popisovače vlastnosti na typ pomocí zadaného názvu vlastnosti, typu a pole atributů.
Equals(Object)	Určí, zda se zadaný objekt rovná 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í popisovače vlastního typu.
GetConverter(Object)	Vrátí převaděč typů pro typ zadané součásti.
GetConverter(Object, Boolean)	Vrátí převaděč typů pro typ zadané komponenty s popisovačem vlastního 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 pro komponentu 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 s popisovačem vlastního typu pro zadanou komponentu.
GetEditor(Type, Type)	Vrátí editor se zadaným základním typem pro zadaný typ.
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 pomocí popisovače vlastního 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í hashovací funkce. (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í popisovače vlastního 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í hodnotu Type , která se dá použít k provedení reflexe daného objektu.
GetReflectionType(Type)	Vrátí hodnotu Type , která se dá použít k provedení reflexe vzhledem k typu třídy.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (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 zadaného modulu 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

Vyvolá se při vymazání mezipaměti pro součást.

Viz také

• EventDescriptor
• PropertyDescriptor
• System.Reflection
• IComponent
• ISite
• Přehled deskriptorů typu
• Reflexe