TypeDescriptor Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Innehåller information om egenskaperna för en komponent, till exempel dess attribut, egenskaper och händelser. Det går inte att ärva den här klassen.
public ref class TypeDescriptor sealed
public sealed class TypeDescriptor
type TypeDescriptor = class
Public NotInheritable Class TypeDescriptor
- Arv
-
TypeDescriptor
Kommentarer
.NET Framework finns två sätt att komma åt metadata på en typ: reflektions-API:et som tillhandahålls i namnområdet System.Reflection och klassen TypeDescriptor. Reflektion är en allmän mekanism som är tillgänglig för alla typer eftersom dess grund är etablerad i GetType metoden för rotklassen Object . Informationen som returneras för en typ är inte utökningsbar, eftersom den inte kan ändras efter kompilering av måltypen. Mer information finns i avsnitten i Reflektion.
Däremot TypeDescriptor är en utökningsbar inspektionsmekanism för komponenter: de klasser som implementerar IComponent gränssnittet. Till skillnad från reflektion inspekterar den inte metoder. TypeDescriptor kan utökas dynamiskt av flera tjänster som är tillgängliga via målkomponentens Site. Följande tabell visar dessa tjänster.
| Tjänstnamn | Description |
|---|---|
| IExtenderProvider | Aktiverar en annan klass, till exempel ToolTip, för att ge extra egenskaper till en komponent. |
| ITypeDescriptorFilterService | Gör att ett annat objekt kan ändra standardmetadata som exponeras av en komponent. |
| ICustomTypeDescriptor | Gör det möjligt för en klass att helt och dynamiskt ange sina egna metadata och ersätta standardgranskningsmekanismen TypeDescriptorför . |
Utökningsbarheten som tillhandahålls av TypeDescriptor gör att designtidsrepresentationen av en komponent kan skilja sig från den faktiska körningsrepresentationen, vilket gör TypeDescriptor det användbart för att skapa infrastruktur för designtid.
Alla metoder i TypeDescriptor är static. Du kan inte skapa en instans av den här klassen och den här klassen kan inte ärvas.
Du kan ange egenskaps- och händelsevärden på två olika sätt: ange dem i komponentklassen eller ändra dem vid designtillfället. Eftersom du kan ange dessa värden på två sätt tar de överlagrade metoderna TypeDescriptor två olika typer av parametrar: en klasstyp eller en objektinstans.
När du vill komma åt TypeDescriptor information och du har en instans av objektet använder du metoden som anropar för en komponent. Använd den metod som endast anropar klasstypen när du inte har någon instans av objektet.
Egenskaper och händelser cachelagras av TypeDescriptor för hastighet. Vanligtvis är de konstanta under ett objekts livslängd. Utökare leverantörer och designers kan dock ändra uppsättningen egenskaper för ett objekt. Om så är fallet Refresh måste metoden anropas för att uppdatera cacheminnet.
Egenskaper
| Name | Description |
|---|---|
| ComNativeDescriptorHandler |
Föråldrad.
Föråldrad.
Hämtar eller anger providern för com-typinformationen (Component Object Model) för målkomponenten. |
| ComObjectType |
Hämtar typen av COM-objekt (Component Object Model) som representeras av målkomponenten. |
| InterfaceType |
Hämtar en typ som representerar en typbeskrivningsprovider för alla gränssnittstyper. |
Metoder
| Name | Description |
|---|---|
| AddAttributes(Object, Attribute[]) |
Lägger till attribut på klassnivå till målkomponentinstansen. |
| AddAttributes(Type, Attribute[]) |
Lägger till attribut på klassnivå till målkomponenttypen. |
| AddEditorTable(Type, Hashtable) |
Lägger till en redigeringstabell för den angivna bastypen för redigeraren. |
| AddProvider(TypeDescriptionProvider, Object) |
Lägger till en typbeskrivningsprovider för en enskild instans av en komponent. |
| AddProvider(TypeDescriptionProvider, Type) |
Lägger till en typbeskrivningsprovider för en komponentklass. |
| AddProviderTransparent(TypeDescriptionProvider, Object) |
Lägger till en typbeskrivningsprovider för en enskild instans av en komponent. |
| AddProviderTransparent(TypeDescriptionProvider, Type) |
Lägger till en typbeskrivningsprovider för en komponentklass. |
| CreateAssociation(Object, Object) |
Skapar en primär-sekundär association mellan två objekt. |
| CreateDesigner(IComponent, Type) |
Skapar en instans av designern som är associerad med den angivna komponenten och av den angivna typen av designer. |
| CreateEvent(Type, EventDescriptor, Attribute[]) |
Skapar en ny händelsebeskrivning som är identisk med en befintlig händelsebeskrivning när den skickas till den befintliga EventDescriptor. |
| CreateEvent(Type, String, Type, Attribute[]) |
Skapar en ny händelsebeskrivning som är identisk med en befintlig händelsebeskrivning genom att dynamiskt generera beskrivande information från en angiven händelse på en typ. |
| CreateInstance(IServiceProvider, Type, Type[], Object[]) |
Skapar ett objekt som kan ersätta en annan datatyp. |
| CreateProperty(Type, PropertyDescriptor, Attribute[]) |
Skapar en ny egenskapsbeskrivning från en befintlig egenskapsbeskrivning med den angivna befintliga PropertyDescriptor matrisen och attributmatrisen. |
| CreateProperty(Type, String, Type, Attribute[]) |
Skapar och binder dynamiskt en egenskapsbeskrivning till en typ med det angivna egenskapsnamnet, typen och attributmatrisen. |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetAssociation(Type, Object) |
Returnerar en instans av den typ som är associerad med det angivna primära objektet. |
| GetAttributes(Object, Boolean) |
Returnerar en samling attribut för den angivna komponenten och ett booleskt värde som anger att en anpassad typbeskrivning har skapats. |
| GetAttributes(Object) |
Returnerar samlingen med attribut för den angivna komponenten. |
| GetAttributes(Type) |
Returnerar en samling attribut för den angivna komponenttypen. |
| GetClassName(Object, Boolean) |
Returnerar namnet på klassen för den angivna komponenten med hjälp av en anpassad typbeskrivning. |
| GetClassName(Object) |
Returnerar namnet på klassen för den angivna komponenten med standardtypbeskrivningen. |
| GetClassName(Type) |
Returnerar namnet på klassen för den angivna typen. |
| GetComponentName(Object, Boolean) |
Returnerar namnet på den angivna komponenten med hjälp av en anpassad typbeskrivning. |
| GetComponentName(Object) |
Returnerar namnet på den angivna komponenten med standardtypbeskrivningen. |
| GetConverter(Object, Boolean) |
Returnerar en typkonverterare för den typ av den angivna komponenten med en anpassad typbeskrivning. |
| GetConverter(Object) |
Returnerar en typkonverterare för den angivna komponentens typ. |
| GetConverter(Type) |
Returnerar en typkonverterare för den angivna typen. |
| GetDefaultEvent(Object, Boolean) |
Returnerar standardhändelsen för en komponent med en anpassad typbeskrivning. |
| GetDefaultEvent(Object) |
Returnerar standardhändelsen för den angivna komponenten. |
| GetDefaultEvent(Type) |
Returnerar standardhändelsen för den angivna komponenttypen. |
| GetDefaultProperty(Object, Boolean) |
Returnerar standardegenskapen för den angivna komponenten med en anpassad typbeskrivning. |
| GetDefaultProperty(Object) |
Returnerar standardegenskapen för den angivna komponenten. |
| GetDefaultProperty(Type) |
Returnerar standardegenskapen för den angivna komponenttypen. |
| GetEditor(Object, Type, Boolean) |
Returnerar en redigerare med den angivna bastypen och med en anpassad typbeskrivning för den angivna komponenten. |
| GetEditor(Object, Type) |
Hämtar en redigerare med den angivna bastypen för den angivna komponenten. |
| GetEditor(Type, Type) |
Returnerar ett redigeringsprogram med den angivna bastypen för den angivna typen. |
| GetEvents(Object, Attribute[], Boolean) |
Returnerar samlingen med händelser för en angiven komponent med en angiven matris med attribut som ett filter och med hjälp av en anpassad typbeskrivning. |
| GetEvents(Object, Attribute[]) |
Returnerar samlingen med händelser för en angiven komponent med en angiven matris med attribut som ett filter. |
| GetEvents(Object, Boolean) |
Returnerar samlingen med händelser för en angiven komponent med en anpassad typbeskrivning. |
| GetEvents(Object) |
Returnerar samlingen med händelser för den angivna komponenten. |
| GetEvents(Type, Attribute[]) |
Returnerar samlingen med händelser för en angiven typ av komponent med en angiven matris med attribut som ett filter. |
| GetEvents(Type) |
Returnerar samlingen med händelser för en angiven typ av komponent. |
| GetFullComponentName(Object) |
Returnerar komponentens fullständigt kvalificerade namn. |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetProperties(Object, Attribute[], Boolean) |
Returnerar samlingen med egenskaper för en angiven komponent med en angiven matris med attribut som ett filter och med hjälp av en anpassad typbeskrivning. |
| GetProperties(Object, Attribute[]) |
Returnerar samlingen med egenskaper för en angiven komponent med en angiven matris med attribut som ett filter. |
| GetProperties(Object, Boolean) |
Returnerar samlingen med egenskaper för en angiven komponent med standardtypbeskrivningen. |
| GetProperties(Object) |
Returnerar samlingen med egenskaper för en angiven komponent. |
| GetProperties(Type, Attribute[]) |
Returnerar samlingen med egenskaper för en angiven typ av komponent med en angiven matris med attribut som ett filter. |
| GetProperties(Type) |
Returnerar samlingen med egenskaper för en angiven typ av komponent. |
| GetProvider(Object) |
Returnerar typbeskrivningsprovidern för den angivna komponenten. |
| GetProvider(Type) |
Returnerar typbeskrivningsprovidern för den angivna typen. |
| GetReflectionType(Object) |
Returnerar en Type som kan användas för att utföra reflektion, givet ett objekt. |
| GetReflectionType(Type) |
Returnerar en Type som kan användas för att utföra reflektion, givet en klasstyp. |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| Refresh(Assembly) |
Rensar egenskaperna och händelserna för den angivna sammansättningen från cacheminnet. |
| Refresh(Module) |
Rensar egenskaperna och händelserna för den angivna modulen från cacheminnet. |
| Refresh(Object) |
Rensar egenskaperna och händelserna för den angivna komponenten från cacheminnet. |
| Refresh(Type) |
Rensar egenskaperna och händelserna för den angivna komponenttypen från cacheminnet. |
| RemoveAssociation(Object, Object) |
Tar bort en association mellan två objekt. |
| RemoveAssociations(Object) |
Tar bort alla associationer för ett primärt objekt. |
| RemoveProvider(TypeDescriptionProvider, Object) |
Tar bort en tidigare tillagd typbeskrivningsprovider som är associerad med det angivna objektet. |
| RemoveProvider(TypeDescriptionProvider, Type) |
Tar bort en tidigare tillagd typbeskrivningsprovider som är associerad med den angivna typen. |
| RemoveProviderTransparent(TypeDescriptionProvider, Object) |
Tar bort en tidigare tillagd typbeskrivningsprovider som är associerad med det angivna objektet. |
| RemoveProviderTransparent(TypeDescriptionProvider, Type) |
Tar bort en tidigare tillagd typbeskrivningsprovider som är associerad med den angivna typen. |
| SortDescriptorArray(IList) |
Sorterar deskriptorer med hjälp av namnet på beskrivningen. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
Händelser
| Name | Description |
|---|---|
| Refreshed |
Inträffar när cachen för en komponent rensas. |