Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
TypeDescriptor-Klasse
Stellt Informationen über die Eigenschaften einer Komponente bereit, z. B. seine Attribute, Eigenschaften und Ereignisse. Diese Klasse kann nicht vererbt werden.
Assembly: System (in System.dll)
Der TypeDescriptor-Typ macht die folgenden Member verfügbar.
| Name | Beschreibung | |
|---|---|---|
|
ComNativeDescriptorHandler | Infrastruktur. Veraltet. Ruft den Anbieter für die Component Object Model-Typinformationen (COM-Typinformationen) für die Zielkomponente ab oder legt diesen fest. |
|
ComObjectType | Ruft den Typ des durch die Zielkomponente dargestellten Component Object Model-Objekts (COM-Objekt) ab. |
|
InterfaceType | Ruft einen Typ ab, der einen Typbeschreibungsanbieter für alle Schnittstellentypen darstellt. |
| Name | Beschreibung | |
|---|---|---|
|
AddAttributes(Object, Attribute[]) | Fügt der Zielkomponenteninstanz Attribute auf Klassenebene hinzu. |
|
AddAttributes(Type, Attribute[]) | Fügt dem Typ der Zielkomponente Attribute auf Klassenebene hinzu. |
|
AddEditorTable | Fügt eine Editortabelle für den angegebenen Editorbasistyp hinzu. |
|
AddProvider(TypeDescriptionProvider, Object) | Fügt einen Typbeschreibungsanbieter für eine einzelne Instanz einer Komponente hinzu. |
|
AddProvider(TypeDescriptionProvider, Type) | Fügt einer Komponentenklasse einen Typbeschreibungsanbieter hinzu. |
|
AddProviderTransparent(TypeDescriptionProvider, Object) | Fügt einen Typbeschreibungsanbieter für eine einzelne Instanz einer Komponente hinzu. |
|
AddProviderTransparent(TypeDescriptionProvider, Type) | Fügt einer Komponentenklasse einen Typbeschreibungsanbieter hinzu. |
|
CreateAssociation | Erstellt eine Zuordnung zwischen einem primären und einem sekundären Objekt. |
|
CreateDesigner | Erstellt eine Instanz des Designers, der der angegebenen Komponente und dem angegebenen Designertyp zugeordnet ist. |
|
CreateEvent(Type, EventDescriptor, Attribute[]) | Erstellt einen neuen Ereignisdeskriptor, der mit einem vorhandenen Ereignisdeskriptor identisch ist, wenn der vorhandene EventDescriptor übergeben wird. |
|
CreateEvent(Type, String, Type, Attribute[]) | Erstellt einen neuen Ereignisdeskriptor, der mit einem vorhandenen Ereignisdeskriptor identisch ist, indem die Deskriptorinformationen aus einem angegebenen Ereignis für einen Typ dynamisch generiert werden. |
|
CreateInstance | Erstellt ein Objekt, das einen anderen Datentyp ersetzen kann. |
|
CreateProperty(Type, PropertyDescriptor, Attribute[]) | Erstellt auf Grundlage eines vorhandenen Eigenschaftendeskriptors einen neuen Eigenschaftendeskriptor. Dazu werden der angegebene vorhandene PropertyDescriptor und das entsprechende Attributarray verwendet. |
|
CreateProperty(Type, String, Type, Attribute[]) | Erstellt einen Eigenschaftendeskriptor und bindet diesen dynamisch an einen Typ. Dazu werden der angegebene Eigenschaftenname, der Typ und das Attributarray verwendet. |
|
Equals(Object) | Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.) |
|
Finalize | Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.) |
|
GetAssociation | Gibt eine Instanz des dem angegebenen primären Objekt zugeordneten Typs zurück. |
|
GetAttributes(Object) | Gibt die Auflistung von Attributen für die angegebene Komponente zurück. |
|
GetAttributes(Type) | Gibt eine Auflistung von Attributen für den angegebenen Komponententyp zurück. |
|
GetAttributes(Object, Boolean) | Gibt eine Auflistung von Attributen für die angegebene Komponente und einen booleschen Wert zurück, der angibt, dass ein benutzerdefinierter Typdeskriptor erstellt wurde. |
|
GetClassName(Object) | Gibt den Namen der Klasse für die angegebene Komponente unter Verwendung des Standardtypdeskriptors zurück. |
|
GetClassName(Type) | Gibt den Namen der Klasse für den angegebenen Typ zurück. |
|
GetClassName(Object, Boolean) | Gibt den Namen der Klasse für die angegebene Komponente unter Verwendung eines benutzerdefinierten Typdeskriptors zurück. |
|
GetComponentName(Object) | Gibt den Namen der angegebenen Komponente unter Verwendung des Standardtypdeskriptors zurück. |
|
GetComponentName(Object, Boolean) | Gibt den Namen der angegebenen Komponente unter Verwendung eines benutzerdefinierten Typdeskriptors zurück. |
|
GetConverter(Object) | Gibt einen Typkonverter für den Typ der angegebenen Komponente zurück. |
|
GetConverter(Type) | Gibt einen Typkonverter für den angegebenen Typ zurück. |
|
GetConverter(Object, Boolean) | Gibt einen Typkonverter für den Typ der angegebenen Komponente mit einem benutzerdefinierten Typdeskriptor zurück. |
|
GetDefaultEvent(Object) | Gibt das Standardereignis für die angegebene Komponente zurück. |
|
GetDefaultEvent(Type) | Gibt das Standardereignis für den angegebenen Komponententyp zurück. |
|
GetDefaultEvent(Object, Boolean) | Gibt das Standardereignis für eine Komponente mit einem benutzerdefinierten Typdeskriptor zurück. |
|
GetDefaultProperty(Object) | Gibt die Standardeigenschaft für die angegebene Komponente zurück. |
|
GetDefaultProperty(Type) | Gibt die Standardeigenschaft für den angegebenen Komponententyp zurück. |
|
GetDefaultProperty(Object, Boolean) | Gibt die Standardeigenschaft für die angegebene Komponente mit einem benutzerdefinierten Typdeskriptor zurück. |
|
GetEditor(Object, Type) | Ruft einen Editor mit dem angegebenen Basistyp für die angegebene Komponente ab. |
|
GetEditor(Type, Type) | Gibt einen Editor mit dem angegebenen Basistyp für den angegebenen Typ zurück. |
|
GetEditor(Object, Type, Boolean) | Gibt einen Editor mit dem angegebenen Basistyp und mit einem benutzerdefinierten Typdeskriptor für die angegebene Komponente zurück. |
|
GetEvents(Object) | Gibt die Auflistung von Ereignissen für die angegebene Komponente zurück. |
|
GetEvents(Type) | Gibt die Auflistung von Ereignissen für einen angegebenen Komponententyp zurück. |
|
GetEvents(Object, Attribute[]) | Gibt die Auflistung von Ereignissen für eine angegebene Komponente zurück, wobei ein angegebenes Array von Attributen als Filter verwendet wird. |
|
GetEvents(Object, Boolean) | Gibt die Auflistung von Ereignissen für eine angegebene Komponente mit einem benutzerdefinierten Typdeskriptor zurück. |
|
GetEvents(Type, Attribute[]) | Gibt die Auflistung von Ereignissen für einen angegebenen Komponententyp zurück, wobei ein angegebenes Array von Attributen als Filter verwendet wird. |
|
GetEvents(Object, Attribute[], Boolean) | Gibt die Auflistung von Ereignissen für eine angegebene Komponente zurück, wobei das angegebene Array von Attributen als Filter fungiert und ein benutzerdefinierter Typdeskriptor verwendet wird. |
|
GetFullComponentName | Gibt den vollqualifizierten Namen der Komponente zurück. |
|
GetHashCode | Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.) |
|
GetProperties(Object) | Gibt die Auflistung von Eigenschaften für eine angegebene Komponente zurück. |
|
GetProperties(Type) | Gibt die Auflistung von Eigenschaften für einen angegebenen Komponententyp zurück. |
|
GetProperties(Object, Attribute[]) | Gibt die Auflistung von Eigenschaften für eine angegebene Komponente zurück, wobei ein angegebenes Array von Attributen als Filter verwendet wird. |
|
GetProperties(Object, Boolean) | Gibt die Auflistung von Eigenschaften für eine angegebene Komponente unter Verwendung des Standardtypdeskriptors zurück. |
|
GetProperties(Type, Attribute[]) | Gibt die Auflistung von Eigenschaften für einen angegebenen Komponententyp zurück, wobei ein angegebenes Array von Attributen als Filter verwendet wird. |
|
GetProperties(Object, Attribute[], Boolean) | Gibt die Auflistung von Eigenschaften für eine angegebene Komponente zurück, wobei das angegebene Array von Attributen als Filter fungiert und ein benutzerdefinierter Typdeskriptor verwendet wird. |
|
GetProvider(Object) | Gibt den Typbeschreibungsanbieter für die angegebene Komponente zurück. |
|
GetProvider(Type) | Gibt den Typbeschreibungsanbieter für den angegebenen Typ zurück. |
|
GetReflectionType(Object) | Gibt einen Type zurück, der verwendet werden kann, um Reflektion für ein Objekt auszuführen. |
|
GetReflectionType(Type) | Gibt einen Type zurück, mit dessen Hilfe Reflektion für einen Klassentyp ausgeführt werden kann. |
|
GetType | Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.) |
|
MemberwiseClone | Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.) |
|
Refresh(Assembly) | Löscht die Eigenschaften und Ereignisse für die angegebene Assembly aus dem Cache. |
|
Refresh(Module) | Löscht die Eigenschaften und Ereignisse für das angegebene Modul aus dem Cache. |
|
Refresh(Object) | Löscht die Eigenschaften und Ereignisse für die angegebene Komponente aus dem Cache. |
|
Refresh(Type) | Löscht die Eigenschaften und Ereignisse für den angegebenen Komponententyp aus dem Cache. |
|
RemoveAssociation | Entfernt eine Zuordnung zwischen zwei Objekten. |
|
RemoveAssociations | Entfernt alle Zuordnungen für ein primäres Objekt. |
|
RemoveProvider(TypeDescriptionProvider, Object) | Entfernt einen zuvor hinzugefügten Typbeschreibungsanbieter, der dem angegebenen Objekt zugeordnet ist. |
|
RemoveProvider(TypeDescriptionProvider, Type) | Entfernt einen zuvor hinzugefügten Typbeschreibungsanbieter, der dem angegebenen Typ zugeordnet ist. |
|
RemoveProviderTransparent(TypeDescriptionProvider, Object) | Entfernt einen zuvor hinzugefügten Typbeschreibungsanbieter, der dem angegebenen Objekt zugeordnet ist. |
|
RemoveProviderTransparent(TypeDescriptionProvider, Type) | Entfernt einen zuvor hinzugefügten Typbeschreibungsanbieter, der dem angegebenen Typ zugeordnet ist. |
|
SortDescriptorArray | Sortiert Deskriptoren nach dem Deskriptornamen. |
|
ToString | Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.) |
| Name | Beschreibung | |
|---|---|---|
|
Refreshed | Tritt ein, wenn der Cache für eine Komponente gelöscht wird. |
.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 überprüft es nicht auf Methoden. TypeDescriptor kann dynamisch über mehrere Dienste, die über die Site der Zielkomponente verfügbar sind, erweitert werden. In der folgenden Tabelle sind diese Dienste aufgeführt.
|
Dienstname |
Beschreibungen |
|---|---|
|
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 diesen Typ oder Member angewendete HostProtectionAttribute-Attribut besitzt den folgenden Resources-Eigenschaftswert: SharedState. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder einer URL in einem Browser gestartet werden). Weitere Informationen finden Sie unter der HostProtectionAttribute-Klasse oder unter SQL Server-Programmierung und Hostschutzattribute. |
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Hinweis