Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

TypeDescriptor-Klasse

Stellt Informationen über die Eigenschaften einer Komponente bereit, z. B. seine Attribute, Eigenschaften und Ereignisse. Diese Klasse kann nicht vererbt werden.

System.Object
  System.ComponentModel.TypeDescriptor

Namespace:  System.ComponentModel
Assembly:  System (in System.dll)
[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)]
public sealed class TypeDescriptor

Der TypeDescriptor-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Eigenschaft Statischer Member ComNativeDescriptorHandler Infrastruktur. Veraltet. Ruft den Anbieter für die Component Object Model-Typinformationen (COM-Typinformationen) für die Zielkomponente ab oder legt diesen fest.
Öffentliche Eigenschaft Statischer Member ComObjectType Ruft den Typ des durch die Zielkomponente dargestellten Component Object Model-Objekts (COM-Objekt) ab.
Öffentliche Eigenschaft Statischer Member InterfaceType Ruft einen Typ ab, der einen Typbeschreibungsanbieter für alle Schnittstellentypen darstellt.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode Statischer Member AddAttributes(Object, Attribute[]) Fügt der Zielkomponenteninstanz Attribute auf Klassenebene hinzu.
Öffentliche Methode Statischer Member AddAttributes(Type, Attribute[]) Fügt dem Typ der Zielkomponente Attribute auf Klassenebene hinzu.
Öffentliche Methode Statischer Member AddEditorTable Fügt eine Editortabelle für den angegebenen Editorbasistyp hinzu.
Öffentliche Methode Statischer Member AddProvider(TypeDescriptionProvider, Object) Fügt einen Typbeschreibungsanbieter für eine einzelne Instanz einer Komponente hinzu.
Öffentliche Methode Statischer Member AddProvider(TypeDescriptionProvider, Type) Fügt einer Komponentenklasse einen Typbeschreibungsanbieter hinzu.
Öffentliche Methode Statischer Member AddProviderTransparent(TypeDescriptionProvider, Object) Fügt einen Typbeschreibungsanbieter für eine einzelne Instanz einer Komponente hinzu.
Öffentliche Methode Statischer Member AddProviderTransparent(TypeDescriptionProvider, Type) Fügt einer Komponentenklasse einen Typbeschreibungsanbieter hinzu.
Öffentliche Methode Statischer Member CreateAssociation Erstellt eine Zuordnung zwischen einem primären und einem sekundären Objekt.
Öffentliche Methode Statischer Member CreateDesigner Erstellt eine Instanz des Designers, der der angegebenen Komponente und dem angegebenen Designertyp zugeordnet ist.
Öffentliche Methode Statischer Member CreateEvent(Type, EventDescriptor, Attribute[]) Erstellt einen neuen Ereignisdeskriptor, der mit einem vorhandenen Ereignisdeskriptor identisch ist, wenn der vorhandene EventDescriptor übergeben wird.
Öffentliche Methode Statischer Member 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.
Öffentliche Methode Statischer Member CreateInstance Erstellt ein Objekt, das einen anderen Datentyp ersetzen kann.
Öffentliche Methode Statischer Member CreateProperty(Type, PropertyDescriptor, Attribute[]) Erstellt auf Grundlage eines vorhandenen Eigenschaftendeskriptors einen neuen Eigenschaftendeskriptor. Dazu werden der angegebene vorhandene PropertyDescriptor und das entsprechende Attributarray verwendet.
Öffentliche Methode Statischer Member 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.
Öffentliche Methode Unterstützt von XNA Framework Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Unterstützt von XNA Framework 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.)
Öffentliche Methode Statischer Member GetAssociation Gibt eine Instanz des dem angegebenen primären Objekt zugeordneten Typs zurück.
Öffentliche Methode Statischer Member GetAttributes(Object) Gibt die Auflistung von Attributen für die angegebene Komponente zurück.
Öffentliche Methode Statischer Member GetAttributes(Type) Gibt eine Auflistung von Attributen für den angegebenen Komponententyp zurück.
Öffentliche Methode Statischer Member 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.
Öffentliche Methode Statischer Member GetClassName(Object) Gibt den Namen der Klasse für die angegebene Komponente unter Verwendung des Standardtypdeskriptors zurück.
Öffentliche Methode Statischer Member GetClassName(Type) Gibt den Namen der Klasse für den angegebenen Typ zurück.
Öffentliche Methode Statischer Member GetClassName(Object, Boolean) Gibt den Namen der Klasse für die angegebene Komponente unter Verwendung eines benutzerdefinierten Typdeskriptors zurück.
Öffentliche Methode Statischer Member GetComponentName(Object) Gibt den Namen der angegebenen Komponente unter Verwendung des Standardtypdeskriptors zurück.
Öffentliche Methode Statischer Member GetComponentName(Object, Boolean) Gibt den Namen der angegebenen Komponente unter Verwendung eines benutzerdefinierten Typdeskriptors zurück.
Öffentliche Methode Statischer Member GetConverter(Object) Gibt einen Typkonverter für den Typ der angegebenen Komponente zurück.
Öffentliche Methode Statischer Member GetConverter(Type) Gibt einen Typkonverter für den angegebenen Typ zurück.
Öffentliche Methode Statischer Member GetConverter(Object, Boolean) Gibt einen Typkonverter für den Typ der angegebenen Komponente mit einem benutzerdefinierten Typdeskriptor zurück.
Öffentliche Methode Statischer Member GetDefaultEvent(Object) Gibt das Standardereignis für die angegebene Komponente zurück.
Öffentliche Methode Statischer Member GetDefaultEvent(Type) Gibt das Standardereignis für den angegebenen Komponententyp zurück.
Öffentliche Methode Statischer Member GetDefaultEvent(Object, Boolean) Gibt das Standardereignis für eine Komponente mit einem benutzerdefinierten Typdeskriptor zurück.
Öffentliche Methode Statischer Member GetDefaultProperty(Object) Gibt die Standardeigenschaft für die angegebene Komponente zurück.
Öffentliche Methode Statischer Member GetDefaultProperty(Type) Gibt die Standardeigenschaft für den angegebenen Komponententyp zurück.
Öffentliche Methode Statischer Member GetDefaultProperty(Object, Boolean) Gibt die Standardeigenschaft für die angegebene Komponente mit einem benutzerdefinierten Typdeskriptor zurück.
Öffentliche Methode Statischer Member GetEditor(Object, Type) Ruft einen Editor mit dem angegebenen Basistyp für die angegebene Komponente ab.
Öffentliche Methode Statischer Member GetEditor(Type, Type) Gibt einen Editor mit dem angegebenen Basistyp für den angegebenen Typ zurück.
Öffentliche Methode Statischer Member GetEditor(Object, Type, Boolean) Gibt einen Editor mit dem angegebenen Basistyp und mit einem benutzerdefinierten Typdeskriptor für die angegebene Komponente zurück.
Öffentliche Methode Statischer Member Unterstützt von XNA Framework GetEvents(Object) Gibt die Auflistung von Ereignissen für die angegebene Komponente zurück.
Öffentliche Methode Statischer Member Unterstützt von XNA Framework GetEvents(Type) Gibt die Auflistung von Ereignissen für einen angegebenen Komponententyp zurück.
Öffentliche Methode Statischer Member Unterstützt von XNA Framework 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.
Öffentliche Methode Statischer Member Unterstützt von XNA Framework GetEvents(Object, Boolean) Gibt die Auflistung von Ereignissen für eine angegebene Komponente mit einem benutzerdefinierten Typdeskriptor zurück.
Öffentliche Methode Statischer Member Unterstützt von XNA Framework 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.
Öffentliche Methode Statischer Member Unterstützt von XNA Framework 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.
Öffentliche Methode Statischer Member GetFullComponentName Gibt den vollqualifizierten Namen der Komponente zurück.
Öffentliche Methode Unterstützt von XNA Framework GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode Statischer Member Unterstützt von XNA Framework GetProperties(Object) Gibt die Auflistung von Eigenschaften für eine angegebene Komponente zurück.
Öffentliche Methode Statischer Member Unterstützt von XNA Framework GetProperties(Type) Gibt die Auflistung von Eigenschaften für einen angegebenen Komponententyp zurück.
Öffentliche Methode Statischer Member 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.
Öffentliche Methode Statischer Member Unterstützt von XNA Framework GetProperties(Object, Boolean) Gibt die Auflistung von Eigenschaften für eine angegebene Komponente unter Verwendung des Standardtypdeskriptors zurück.
Öffentliche Methode Statischer Member 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.
Öffentliche Methode Statischer Member 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.
Öffentliche Methode Statischer Member GetProvider(Object) Gibt den Typbeschreibungsanbieter für die angegebene Komponente zurück.
Öffentliche Methode Statischer Member GetProvider(Type) Gibt den Typbeschreibungsanbieter für den angegebenen Typ zurück.
Öffentliche Methode Statischer Member GetReflectionType(Object) Gibt einen Type zurück, der verwendet werden kann, um Reflektion für ein Objekt auszuführen.
Öffentliche Methode Statischer Member GetReflectionType(Type) Gibt einen Type zurück, mit dessen Hilfe Reflektion für einen Klassentyp ausgeführt werden kann.
Öffentliche Methode Unterstützt von XNA Framework GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte Methode Unterstützt von XNA Framework MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche Methode Statischer Member Refresh(Assembly) Löscht die Eigenschaften und Ereignisse für die angegebene Assembly aus dem Cache.
Öffentliche Methode Statischer Member Refresh(Module) Löscht die Eigenschaften und Ereignisse für das angegebene Modul aus dem Cache.
Öffentliche Methode Statischer Member Refresh(Object) Löscht die Eigenschaften und Ereignisse für die angegebene Komponente aus dem Cache.
Öffentliche Methode Statischer Member Refresh(Type) Löscht die Eigenschaften und Ereignisse für den angegebenen Komponententyp aus dem Cache.
Öffentliche Methode Statischer Member RemoveAssociation Entfernt eine Zuordnung zwischen zwei Objekten.
Öffentliche Methode Statischer Member RemoveAssociations Entfernt alle Zuordnungen für ein primäres Objekt.
Öffentliche Methode Statischer Member RemoveProvider(TypeDescriptionProvider, Object) Entfernt einen zuvor hinzugefügten Typbeschreibungsanbieter, der dem angegebenen Objekt zugeordnet ist.
Öffentliche Methode Statischer Member RemoveProvider(TypeDescriptionProvider, Type) Entfernt einen zuvor hinzugefügten Typbeschreibungsanbieter, der dem angegebenen Typ zugeordnet ist.
Öffentliche Methode Statischer Member RemoveProviderTransparent(TypeDescriptionProvider, Object) Entfernt einen zuvor hinzugefügten Typbeschreibungsanbieter, der dem angegebenen Objekt zugeordnet ist.
Öffentliche Methode Statischer Member RemoveProviderTransparent(TypeDescriptionProvider, Type) Entfernt einen zuvor hinzugefügten Typbeschreibungsanbieter, der dem angegebenen Typ zugeordnet ist.
Öffentliche Methode Statischer Member SortDescriptorArray Sortiert Deskriptoren nach dem Deskriptornamen.
Öffentliche Methode Unterstützt von XNA Framework ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang
  Name Beschreibung
Öffentliches Ereignis Statischer Member Refreshed Tritt ein, wenn der Cache für eine Komponente gelöscht wird.
Zum Seitenanfang

.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

IExtenderProvider

Aktiviert eine andere Klasse, z. B. ToolTip, um zusätzliche Eigenschaften für eine Komponente bereitzustellen.

ITypeDescriptorFilterService

Aktiviert ein anderes Objekt, um die Standardmetadaten zu ändern, die von einer Komponente verfügbar gemacht werden.

ICustomTypeDescriptor

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 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.

.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

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.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?