TypeDescriptor Osztály

Definíció

Névtér:

System.ComponentModel

Szerelvények:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Forrás:

TypeDescriptor.cs

Információt nyújt az összetevők jellemzőiről, például attribútumairól, tulajdonságairól és eseményeiről. Ez az osztály nem örökölhető.

public ref class TypeDescriptor sealed

public sealed class TypeDescriptor

type TypeDescriptor = class

Public NotInheritable Class TypeDescriptor

Öröklődés

Object

TypeDescriptor

Megjegyzések

A .NET-keretrendszer kétféleképpen érheti el a metaadatokat egy típuson: a System.Reflection névtérben biztosított tükröződési API-t és a TypeDescriptor osztályt. A tükröződés egy általános mechanizmus, amely minden típus számára elérhető, mivel alapja a GetType gyökérosztály Object metódusában van létrehozva. A típushoz visszaadott információk nem bővíthetők, mivel a céltípus összeállítása után nem módosíthatók. További információkért tekintse meg a Reflection témakörét.

Ezzel szemben TypeDescriptor egy bővíthető ellenőrzési mechanizmus az összetevőkhöz: az interfészt IComponent implementáló osztályokhoz. A tükröződéssel ellentétben nem vizsgálja meg a módszereket. TypeDescriptor a célösszetevőn Sitekeresztül elérhető számos szolgáltatással dinamikusan bővíthető. Az alábbi táblázat ezeket a szolgáltatásokat mutatja be.

Szolgáltatás neve	Leírás
IExtenderProvider	Lehetővé teszi egy másik osztály, például ToolTipaz összetevők további tulajdonságainak biztosítását.
ITypeDescriptorFilterService	Lehetővé teszi, hogy egy másik objektum módosítsa az összetevő által közzétett szabványos metaadatokat.
ICustomTypeDescriptor	Lehetővé teszi, hogy az osztály teljesen és dinamikusan adja meg a saját metaadatait, lecserélve a szabványos ellenőrzési mechanizmust TypeDescriptor.

A bővíthetőség lehetővé TypeDescriptor teszi, hogy egy összetevő tervezési idő ábrázolása eltérjen a tényleges futásidejű ábrázolástól, ami hasznossá teszi TypeDescriptor a tervezési idejű infrastruktúra kiépítését.

Az összes metódus a következő TypeDescriptorstatic: . Ennek az osztálynak nem hozható létre példánya, és ez az osztály nem örökölhető.

A tulajdonság- és eseményértékek kétféleképpen állíthatók be: megadhatja őket az összetevőosztályban, vagy módosíthatja őket a tervezéskor. Mivel ezeket az értékeket kétféleképpen állíthatja be, a túlterhelt metódusok TypeDescriptor két különböző paramétertípust használnak: egy osztálytípust vagy egy objektumpéldányt.

Ha hozzá szeretne férni az adatokhoz TypeDescriptor , és rendelkezik az objektum egy példányával, használja az összetevőt hívó metódust. Az osztálytípust csak akkor hívhatja meg, ha nem rendelkezik objektumpéldánysal.

A tulajdonságok és események gyorsítótárazva TypeDescriptor vannak a sebesség érdekében. Ezek általában egy objektum élettartamának állandói. A bővítőszolgáltatók és a tervezők azonban módosíthatják az objektumok tulajdonságainak készletét. Ha ez a helyzet, akkor a gyorsítótár frissítéséhez meg Refresh kell hívni a metódust.

Tulajdonságok

Name	Description
ComNativeDescriptorHandler	Elavult. Lekéri vagy beállítja a célösszetevőhöz tartozó komponensobjektum-modell (COM) típusadatait.
ComObjectType	Lekéri a célösszetevő által képviselt komponensobjektum-modell (COM) objektum típusát.
InterfaceType	Olyan típust kap, amely az összes felülettípushoz egy típusleírás-szolgáltatót jelöl.

Metódusok

Name	Description
AddAttributes(Object, Attribute[])	Osztályszintű attribútumokat ad hozzá a célösszetevő-példányhoz.
AddAttributes(Type, Attribute[])	Osztályszintű attribútumokat ad hozzá a célösszetevő-típushoz.
AddEditorTable(Type, Hashtable)	Hozzáad egy szerkesztőtáblát az adott szerkesztő alaptípusához.
AddProvider(TypeDescriptionProvider, Object)	Egy összetevő egyetlen példányához ad hozzá egy típusleírás-szolgáltatót.
AddProvider(TypeDescriptionProvider, Type)	Típusleírás-szolgáltatót ad hozzá egy összetevőosztályhoz.
AddProviderTransparent(TypeDescriptionProvider, Object)	Egy összetevő egyetlen példányához ad hozzá egy típusleírás-szolgáltatót.
AddProviderTransparent(TypeDescriptionProvider, Type)	Típusleírás-szolgáltatót ad hozzá egy összetevőosztályhoz.
CreateAssociation(Object, Object)	Létrehoz egy elsődleges-másodlagos társítás két objektum között.
CreateDesigner(IComponent, Type)	Létrehozza a megadott összetevőhöz és a megadott tervezőtípushoz társított tervezőpéldányt.
CreateEvent(Type, EventDescriptor, Attribute[])	Létrehoz egy új eseményleírót, amely megegyezik egy meglévő eseményleíróval, amikor a meglévőt EventDescriptorátadja.
CreateEvent(Type, String, Type, Attribute[])	Létrehoz egy új eseményleírót, amely megegyezik egy meglévő eseményleíróval úgy, hogy dinamikusan generál leíró adatokat egy adott eseményből egy típuson.
CreateInstance(IServiceProvider, Type, Type[], Object[])	Létrehoz egy objektumot, amely helyettesítheti egy másik adattípust.
CreateProperty(Type, PropertyDescriptor, Attribute[])	Új tulajdonságleírót hoz létre egy meglévő tulajdonságleíróból a megadott meglévő PropertyDescriptor és attribútumtömb használatával.
CreateProperty(Type, String, Type, Attribute[])	Létrehoz és dinamikusan köt egy tulajdonságleírót egy típushoz a megadott tulajdonságnév, típus és attribútumtömb használatával.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetAssociation(Type, Object)	A megadott elsődleges objektumhoz társított típuspéldányt adja vissza.
GetAttributes(Object, Boolean)	A megadott összetevőhöz tartozó attribútumgyűjteményt és egy logikai értéket ad vissza, amely azt jelzi, hogy létre lett hozva egy egyéni típusú leíró.
GetAttributes(Object)	A megadott összetevő attribútumainak gyűjteményét adja vissza.
GetAttributes(Type)	A megadott típusú összetevő attribútumgyűjteményét adja vissza.
GetClassName(Object, Boolean)	A megadott összetevő osztályának nevét adja vissza egyéni típusleíró használatával.
GetClassName(Object)	A megadott összetevő osztályának nevét adja vissza az alapértelmezett típusleíró használatával.
GetClassName(Type)	A megadott típus osztályának nevét adja vissza.
GetComponentName(Object, Boolean)	A megadott összetevő nevét adja vissza egyéni típusleíró használatával.
GetComponentName(Object)	A megadott összetevő nevét adja vissza az alapértelmezett típusleíró használatával.
GetConverter(Object, Boolean)	A megadott összetevő típuskonverterét adja vissza egyéni típusleíróval.
GetConverter(Object)	A megadott összetevő típuskonverterét adja vissza.
GetConverter(Type)	Egy típuskonvertert ad vissza a megadott típushoz.
GetConverterFromRegisteredType(Object)	Lekéri a megadott összetevő típuskonverterét.
GetConverterFromRegisteredType(Type)	Lekéri a megadott regisztrált típus típuskonverterét.
GetDefaultEvent(Object, Boolean)	Egy egyéni típusú leíróval rendelkező összetevő alapértelmezett eseményét adja vissza.
GetDefaultEvent(Object)	A megadott összetevő alapértelmezett eseményét adja vissza.
GetDefaultEvent(Type)	A megadott összetevőtípus alapértelmezett eseményét adja vissza.
GetDefaultProperty(Object, Boolean)	A megadott összetevő alapértelmezett tulajdonságát adja vissza egyéni típusleíróval.
GetDefaultProperty(Object)	A megadott összetevő alapértelmezett tulajdonságát adja vissza.
GetDefaultProperty(Type)	A megadott összetevőtípus alapértelmezett tulajdonságát adja vissza.
GetEditor(Object, Type, Boolean)	A megadott alaptípussal és a megadott összetevő egyéni típusleírójával rendelkező szerkesztőt ad vissza.
GetEditor(Object, Type)	Lekéri a megadott összetevőhöz megadott alaptípusú szerkesztőt.
GetEditor(Type, Type)	A megadott típushoz megadott alaptípussal rendelkező szerkesztőt ad vissza.
GetEvents(Object, Attribute[], Boolean)	Egy adott összetevő eseménygyűjteményét adja vissza egy megadott attribútumtömb szűrőként és egyéni típusleíró használatával.
GetEvents(Object, Attribute[])	Egy adott összetevő eseménygyűjteményét adja vissza egy megadott attribútumtömb használatával szűrőként.
GetEvents(Object, Boolean)	Egy adott összetevő eseménygyűjteményét adja vissza egyéni típusleíróval.
GetEvents(Object)	A megadott összetevő eseménygyűjteményét adja vissza.
GetEvents(Type, Attribute[])	Egy adott típusú összetevő eseménygyűjteményét adja vissza egy megadott attribútumtömb használatával szűrőként.
GetEvents(Type)	Egy adott típusú összetevő eseménygyűjteményét adja vissza.
GetEventsFromRegisteredType(Type)	Lekéri egy adott típusú összetevő eseménygyűjteményét.
GetFullComponentName(Object)	Az összetevő teljes nevét adja vissza.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetProperties(Object, Attribute[], Boolean)	Egy adott összetevő tulajdonságainak gyűjteményét adja vissza egy megadott attribútumtömb szűrőként és egyéni típusleíró használatával.
GetProperties(Object, Attribute[])	Egy adott összetevő tulajdonságainak gyűjteményét adja vissza egy megadott attribútumtömb használatával szűrőként.
GetProperties(Object, Boolean)	Egy adott összetevő tulajdonságainak gyűjteményét adja vissza az alapértelmezett típusleíró használatával.
GetProperties(Object)	Egy adott összetevő tulajdonságainak gyűjteményét adja vissza.
GetProperties(Type, Attribute[])	Egy adott típusú összetevő tulajdonságainak gyűjteményét adja vissza egy megadott attribútumtömb használatával szűrőként.
GetProperties(Type)	Egy adott típusú összetevő tulajdonságainak gyűjteményét adja vissza.
GetPropertiesFromRegisteredType(Object)	Lekéri egy adott összetevő tulajdonságainak gyűjteményét.
GetPropertiesFromRegisteredType(Type)	Lekéri a megadott típushoz tartozó tulajdonságok gyűjteményét.
GetProvider(Object)	A megadott összetevő típusleírás-szolgáltatójának értékét adja vissza.
GetProvider(Type)	A megadott típus típusleírás-szolgáltatójának értékét adja vissza.
GetReflectionType(Object)	Olyan értéket Type ad vissza, amely egy objektumra adott visszaverődés végrehajtására használható.
GetReflectionType(Type)	Olyan értéket Type ad vissza, amely egy osztálytípus alapján tükrözés végrehajtására használható.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
Refresh(Assembly)	Törli a megadott szerelvény tulajdonságait és eseményeit a gyorsítótárból.
Refresh(Module)	Törli a megadott modul tulajdonságait és eseményeit a gyorsítótárból.
Refresh(Object)	Törli a megadott összetevő tulajdonságait és eseményeit a gyorsítótárból.
Refresh(Type)	Törli a megadott típusú összetevő tulajdonságait és eseményeit a gyorsítótárból.
RegisterType<T>()	Regisztrálja a típust, hogy tükröződésalapú szolgáltatók használhassák a levágott alkalmazásokban.
RemoveAssociation(Object, Object)	Két objektum közötti társítás eltávolítása.
RemoveAssociations(Object)	Eltávolítja az elsődleges objektum összes társítását.
RemoveProvider(TypeDescriptionProvider, Object)	Eltávolít egy korábban hozzáadott típusleírás-szolgáltatót, amely a megadott objektumhoz van társítva.
RemoveProvider(TypeDescriptionProvider, Type)	Eltávolít egy korábban hozzáadott típusleírás-szolgáltatót, amely a megadott típushoz van társítva.
RemoveProviderTransparent(TypeDescriptionProvider, Object)	Eltávolít egy korábban hozzáadott típusleírás-szolgáltatót, amely a megadott objektumhoz van társítva.
RemoveProviderTransparent(TypeDescriptionProvider, Type)	Eltávolít egy korábban hozzáadott típusleírás-szolgáltatót, amely a megadott típushoz van társítva.
SortDescriptorArray(IList)	A leírók rendezése a leíró nevével.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

esemény

Name	Description
Refreshed	Az összetevő gyorsítótárának törlésekor fordul elő.

Lásd még

• EventDescriptor
• PropertyDescriptor
• System.Reflection
• IComponent
• ISite
• Típusleíró áttekintése
• Visszaverődés