TypeDescriptor-Klasse
Stellt Informationen über die Eigenschaften einer Komponente bereit, z. B. seine Attribute, Eigenschaften und Ereignisse. Diese Klasse kann nicht geerbt werden.
Namespace: System.ComponentModel
Assembly: System (in system.dll)
Syntax
'Declaration
Public NotInheritable Class TypeDescriptor
'Usage
Dim instance As TypeDescriptor
public sealed class TypeDescriptor
public ref class TypeDescriptor sealed
public final class TypeDescriptor
public final class TypeDescriptor
Hinweise
.NET Framework bietet zwei unterschiedliche Arten des Zugriffs auf Metadaten zu einem Typ: über die im System.Reflection-Namespace bereitgestellte Reflektions-API und über die TypeDescriptor-Klasse. Reflektion ist ein allgemeiner Mechanismus, der allen Typen zur Verfügung steht, da er auf der GetType-Methode der Object-Stammklasse basiert. Die von ihr zurückgegebene Information zu einem Typ ist nicht erweiterbar, insofern kann sie nach der Kompilierung des Zieltyps nicht geändert werden. Weitere Informationen finden Sie in den Themen unter Reflektion.
Im Gegensatz dazu stellt TypeDescriptor einen erweiterbaren Inspektionsmechanismus für Komponenten dar: für die Klassen, die die IComponent-Schnittstelle implementieren. Im Gegensatz zur Reflektion sucht er nicht nach Methoden. TypeDescriptor kann mithilfe mehrerer, über die Site der Zielkomponente verfügbarer Dienste dynamisch erweitert werden. In der folgenden Tabelle sind diese Dienste aufgeführt.
Name des Diensts |
Beschreibung |
|---|---|
Aktiviert eine andere Klasse, z. B. ToolTip, um zusätzliche Eigenschaften für eine Komponente bereitzustellen. |
|
Aktiviert ein anderes Objekt, um die Standardmetadaten zu ändern, die von einer Komponente verfügbar gemacht werden. |
|
Ermöglicht es einer Klasse, ihre eigenen Metadaten vollständig und dynamisch anzugeben, und ersetzt dadurch den Standardinspektionsmechanismus des TypeDescriptor. |
Die vom TypeDescriptor bereitgestellte Erweiterbarkeit erlaubt es, dass sich die Darstellung einer Komponente zur Entwurfszeit von ihrer tatsächlichen Darstellung zur Laufzeit unterscheidet, weshalb der TypeDescriptor für die Erstellung einer Infrastruktur zur Entwurfszeit von Nutzen ist.
Alle Methoden im TypeDescriptor sind static. Sie können keine Instanz dieser Klasse erstellen, und diese Klasse kann nicht geerbt werden.
Sie können die Werte von Eigenschaften und Ereignissen auf zwei unterschiedliche Arten festlegen, d. h., Sie können sie entweder in der Komponentenklasse angeben oder zur Entwurfszeit ändern. Da diese Werte auf zwei unterschiedliche Arten festgelegt werden können, akzeptieren die überladenen Methoden des TypeDescriptor zwei unterschiedliche Parametertypen: einen Klassentyp oder eine Objektinstanz.
Wenn Sie auf TypeDescriptor-Informationen zugreifen möchten und über eine Instanz des Objekts verfügen, verwenden Sie die Methode, für die eine Komponente erforderlich ist. Verwenden Sie nur dann die Methode, an die der Klassentyp übergeben wird, wenn keine Instanz des Objekts vorhanden ist.
Eigenschaften und Ereignisse werden aus Gründen der Geschwindigkeit von TypeDescriptor zwischengespeichert. Normalerweise bleiben sie während der Lebensdauer eines Objekts konstant. Extenderanbieter und Designer können jedoch den Satz der Eigenschaften für ein Objekt ändern. In diesem Fall muss der Cache über den Aufruf der Refresh-Methode aktualisiert werden.
Hinweis
Das auf diese Klasse angewendete HostProtectionAttribute-Attribut besitzt den Resources-Eigenschaftenwert SharedState. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder eines URL in einem Browser gestartet werden). Weitere Informationen finden Sie unter der HostProtectionAttribute-Klasse oder unter SQL Server-Programmierung und Hostschutzattribute.
Vererbungshierarchie
System.Object
System.ComponentModel.TypeDescriptor
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
TypeDescriptor-Member
System.ComponentModel-Namespace
EventDescriptor-Klasse
PropertyDescriptor-Klasse
System.Reflection
IComponent-Schnittstelle
ISite-Schnittstelle