TypeDescriptor TypeDescriptor TypeDescriptor TypeDescriptor Class

Definizione

Offre informazioni sulle caratteristiche di un componente, ad esempio gli attributi, le proprietà e gli eventi.Provides information about the characteristics for a component, such as its attributes, properties, and events. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class TypeDescriptor sealed
public sealed class TypeDescriptor
type TypeDescriptor = class
Public NotInheritable Class TypeDescriptor
Ereditarietà
TypeDescriptorTypeDescriptorTypeDescriptorTypeDescriptor

Commenti

.NET Framework offre due modi per accedere ai metadati in un tipo: l'API reflection fornita nel System.Reflection dello spazio dei nomi e il TypeDescriptor classe.The .NET Framework provides two ways to access metadata on a type: the reflection API provided in the System.Reflection namespace, and the TypeDescriptor class. Reflection è un meccanismo generale disponibile a tutti i tipi perché la relativa base è definita nel GetType metodo della radice Object classe.Reflection is a general mechanism available to all types because its foundation is established in the GetType method of the root Object class. Le informazioni restituite per un tipo non sono estendibile, in quanto non può essere modificato dopo la compilazione del tipo di destinazione.The information it returns for a type is not extensible, in that it cannot be modified after compilation of the target type. Per altre informazioni, vedere gli argomenti in Reflection.For more information, see the topics in Reflection.

Al contrario, TypeDescriptor è un meccanismo di analisi estendibile per i componenti: le classi che implementano il IComponent interfaccia.In contrast, TypeDescriptor is an extensible inspection mechanism for components: those classes that implement the IComponent interface. A differenza di reflection, non prevede una verifica per i metodi.Unlike reflection, it does not inspect for methods. TypeDescriptor può essere esteso in modo dinamico da diversi servizi disponibili tramite il componente di destinazione Site.TypeDescriptor can be dynamically extended by several services available through the target component's Site. La tabella seguente illustra questi servizi.The following table shows these services.

Nome del servizioService name DescrizioneDescription
IExtenderProvider Consente a un'altra classe, ad esempio ToolTip, per fornire proprietà aggiuntive per un componente.Enables another class, such as ToolTip, to provide extra properties to a component.
ITypeDescriptorFilterService Consente di modificare i metadati standard che viene esposto da un componente di un altro oggetto.Enables another object to modify the standard metadata that is exposed by a component.
ICustomTypeDescriptor Consente a una classe completamente in modo dinamico e di specificare i propri metadati, sostituendo il meccanismo di controllo standard di TypeDescriptor.Enables a class to completely and dynamically specify its own metadata, replacing the standard inspection mechanism of TypeDescriptor.

L'estendibilità disql TypeDescriptor consente la rappresentazione della fase di progettazione di un componente in modo diverso dalla relativa rappresentazione in fase di esecuzione effettivo, che rende TypeDescriptor utili per la creazione dell'infrastruttura in fase di progettazione.The extensibility provided by TypeDescriptor allows the design-time representation of a component to differ from its actual run-time representation, which makes TypeDescriptor useful for building design-time infrastructure.

Tutti i metodi TypeDescriptor sono static.All the methods in TypeDescriptor are static. Non è possibile creare un'istanza di questa classe e questa classe non può essere ereditata.You cannot create an instance of this class, and this class cannot be inherited.

È possibile impostare proprietà e valori di evento in due modi: specificarli nella classe del componente o modificarli in fase di progettazione.You can set property and event values two different ways: specify them in the component class or change them at design time. Poiché è possibile impostare questi valori di due modi, metodi di overload di TypeDescriptor richiedere due diversi tipi di parametri: un tipo di classe o un'istanza dell'oggetto.Because you can set these values two ways, the overloaded methods of TypeDescriptor take two different types of parameters: a class type or an object instance.

Quando si desidera accedere TypeDescriptor informazioni e si dispone di un'istanza dell'oggetto, usare il metodo che chiama un componente.When you want to access TypeDescriptor information and you have an instance of the object, use the method that calls for a component. Usare il metodo che chiama per il tipo di classe solo quando non è un'istanza dell'oggetto.Use the method that calls for the class type only when you do not have an instance of the object.

Proprietà ed eventi vengono memorizzati nella cache da TypeDescriptor per la velocità.Properties and events are cached by TypeDescriptor for speed. In genere, sono costanti per la durata di un oggetto.Typically, they are constant for the lifetime of an object. Tuttavia, le finestre di progettazione e i provider di estensione possono modificare il set di proprietà in un oggetto.However, extender providers and designers can change the set of properties on an object. In questo caso, il Refresh metodo deve essere chiamato per aggiornare la cache.If this is the case, then the Refresh method must be called to update the cache.

Proprietà

ComNativeDescriptorHandler ComNativeDescriptorHandler ComNativeDescriptorHandler ComNativeDescriptorHandler

Ottiene o imposta il provider di informazioni sul tipo COM (Component Object Model) per il componente di destinazione.Gets or sets the provider for the Component Object Model (COM) type information for the target component.

ComObjectType ComObjectType ComObjectType ComObjectType

Ottiene il tipo di oggetto COM (Component Object Model) rappresentato dal componente di destinazione.Gets the type of the Component Object Model (COM) object represented by the target component.

InterfaceType InterfaceType InterfaceType InterfaceType

Ottiene un tipo che rappresenta un provider di descrizione del tipo per tutti i tipi di interfaccia.Gets a type that represents a type description provider for all interface types.

Metodi

AddAttributes(Object, Attribute[]) AddAttributes(Object, Attribute[]) AddAttributes(Object, Attribute[]) AddAttributes(Object, Attribute[])

Aggiunge attributi a livello di classe all'istanza del componente di destinazione.Adds class-level attributes to the target component instance.

AddAttributes(Type, Attribute[]) AddAttributes(Type, Attribute[]) AddAttributes(Type, Attribute[]) AddAttributes(Type, Attribute[])

Aggiunge attributi a livello di classe al tipo del componente di destinazione.Adds class-level attributes to the target component type.

AddEditorTable(Type, Hashtable) AddEditorTable(Type, Hashtable) AddEditorTable(Type, Hashtable) AddEditorTable(Type, Hashtable)

Aggiunge una tabella editor per il tipo base dell'editor indicato.Adds an editor table for the given editor base type.

AddProvider(TypeDescriptionProvider, Object) AddProvider(TypeDescriptionProvider, Object) AddProvider(TypeDescriptionProvider, Object) AddProvider(TypeDescriptionProvider, Object)

Aggiunge un provider della descrizione del tipo per una singola istanza di un componente.Adds a type description provider for a single instance of a component.

AddProvider(TypeDescriptionProvider, Type) AddProvider(TypeDescriptionProvider, Type) AddProvider(TypeDescriptionProvider, Type) AddProvider(TypeDescriptionProvider, Type)

Aggiunge un provider della descrizione del tipo per una classe del componente.Adds a type description provider for a component class.

AddProviderTransparent(TypeDescriptionProvider, Object) AddProviderTransparent(TypeDescriptionProvider, Object) AddProviderTransparent(TypeDescriptionProvider, Object) AddProviderTransparent(TypeDescriptionProvider, Object)

Aggiunge un provider della descrizione del tipo per una singola istanza di un componente.Adds a type description provider for a single instance of a component.

AddProviderTransparent(TypeDescriptionProvider, Type) AddProviderTransparent(TypeDescriptionProvider, Type) AddProviderTransparent(TypeDescriptionProvider, Type) AddProviderTransparent(TypeDescriptionProvider, Type)

Aggiunge un provider della descrizione del tipo per una classe del componente.Adds a type description provider for a component class.

CreateAssociation(Object, Object) CreateAssociation(Object, Object) CreateAssociation(Object, Object) CreateAssociation(Object, Object)

Crea un'associazione primaria/secondaria tra due oggetti.Creates a primary-secondary association between two objects.

CreateDesigner(IComponent, Type) CreateDesigner(IComponent, Type) CreateDesigner(IComponent, Type) CreateDesigner(IComponent, Type)

Crea un'istanza della finestra di progettazione associata al componente specificato e del tipo di finestra di progettazione specificato.Creates an instance of the designer associated with the specified component and of the specified type of designer.

CreateEvent(Type, EventDescriptor, Attribute[]) CreateEvent(Type, EventDescriptor, Attribute[]) CreateEvent(Type, EventDescriptor, Attribute[]) CreateEvent(Type, EventDescriptor, Attribute[])

Crea un nuovo descrittore di eventi che è identico a un descrittore esistente, quando viene passato l'oggetto esistente EventDescriptor.Creates a new event descriptor that is identical to an existing event descriptor, when passed the existing EventDescriptor.

CreateEvent(Type, String, Type, Attribute[]) CreateEvent(Type, String, Type, Attribute[]) CreateEvent(Type, String, Type, Attribute[]) CreateEvent(Type, String, Type, Attribute[])

Crea un nuovo descrittore di eventi identico a un descrittore di eventi esistente generando dinamicamente le informazioni sul descrittore da un evento specificato su un tipo.Creates a new event descriptor that is identical to an existing event descriptor by dynamically generating descriptor information from a specified event on a type.

CreateInstance(IServiceProvider, Type, Type[], Object[]) CreateInstance(IServiceProvider, Type, Type[], Object[]) CreateInstance(IServiceProvider, Type, Type[], Object[]) CreateInstance(IServiceProvider, Type, Type[], Object[])

Crea un oggetto che può sostituire un altro tipo di dati.Creates an object that can substitute for another data type.

CreateProperty(Type, PropertyDescriptor, Attribute[]) CreateProperty(Type, PropertyDescriptor, Attribute[]) CreateProperty(Type, PropertyDescriptor, Attribute[]) CreateProperty(Type, PropertyDescriptor, Attribute[])

Crea un nuovo descrittore di proprietà da un descrittore di proprietà esistente, usando l'oggetto PropertyDescriptor e la matrice di attributi specificati.Creates a new property descriptor from an existing property descriptor, using the specified existing PropertyDescriptor and attribute array.

CreateProperty(Type, String, Type, Attribute[]) CreateProperty(Type, String, Type, Attribute[]) CreateProperty(Type, String, Type, Attribute[]) CreateProperty(Type, String, Type, Attribute[])

Crea e associa dinamicamente un descrittore di proprietà a un tipo, usando il nome della proprietà, il tipo e la matrice di attributi specificati.Creates and dynamically binds a property descriptor to a type, using the specified property name, type, and attribute array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetAssociation(Type, Object) GetAssociation(Type, Object) GetAssociation(Type, Object) GetAssociation(Type, Object)

Restituisce un'istanza del tipo associato all'oggetto primario specificato.Returns an instance of the type associated with the specified primary object.

GetAttributes(Object) GetAttributes(Object) GetAttributes(Object) GetAttributes(Object)

Restituisce l'insieme di attributi per il componente specificato.Returns the collection of attributes for the specified component.

GetAttributes(Object, Boolean) GetAttributes(Object, Boolean) GetAttributes(Object, Boolean) GetAttributes(Object, Boolean)

Restituisce un insieme di attributi per il componente specificato e un valore booleano che indica che è stato creato un descrittore di tipi personalizzato.Returns a collection of attributes for the specified component and a Boolean indicating that a custom type descriptor has been created.

GetAttributes(Type) GetAttributes(Type) GetAttributes(Type) GetAttributes(Type)

Restituisce un insieme di attributi per il tipo di componente specificato.Returns a collection of attributes for the specified type of component.

GetClassName(Object) GetClassName(Object) GetClassName(Object) GetClassName(Object)

Restituisce il nome della classe per il componente specificato utilizzando il descrittore di tipi predefinito.Returns the name of the class for the specified component using the default type descriptor.

GetClassName(Object, Boolean) GetClassName(Object, Boolean) GetClassName(Object, Boolean) GetClassName(Object, Boolean)

Restituisce il nome della classe per il componente specificato utilizzando un descrittore di tipi personalizzato.Returns the name of the class for the specified component using a custom type descriptor.

GetClassName(Type) GetClassName(Type) GetClassName(Type) GetClassName(Type)

Restituisce il nome della classe per il tipo specificato.Returns the name of the class for the specified type.

GetComponentName(Object) GetComponentName(Object) GetComponentName(Object) GetComponentName(Object)

Restituisce il nome del componente specificato utilizzando il descrittore di tipi predefinito.Returns the name of the specified component using the default type descriptor.

GetComponentName(Object, Boolean) GetComponentName(Object, Boolean) GetComponentName(Object, Boolean) GetComponentName(Object, Boolean)

Restituisce il nome del componente specificato utilizzando un descrittore di tipi personalizzato.Returns the name of the specified component using a custom type descriptor.

GetConverter(Object) GetConverter(Object) GetConverter(Object) GetConverter(Object)

Restituisce un convertitore di tipi per il tipo del componente specificato.Returns a type converter for the type of the specified component.

GetConverter(Object, Boolean) GetConverter(Object, Boolean) GetConverter(Object, Boolean) GetConverter(Object, Boolean)

Restituisce un convertitore di tipi per il tipo del componente specificato con un descrittore di tipi personalizzato.Returns a type converter for the type of the specified component with a custom type descriptor.

GetConverter(Type) GetConverter(Type) GetConverter(Type) GetConverter(Type)

Restituisce un convertitore di tipi per il tipo specificato.Returns a type converter for the specified type.

GetDefaultEvent(Object) GetDefaultEvent(Object) GetDefaultEvent(Object) GetDefaultEvent(Object)

Restituisce l'evento predefinito per il componente specificato.Returns the default event for the specified component.

GetDefaultEvent(Object, Boolean) GetDefaultEvent(Object, Boolean) GetDefaultEvent(Object, Boolean) GetDefaultEvent(Object, Boolean)

Restituisce l'evento predefinito per un componente con un descrittore di tipi personalizzato.Returns the default event for a component with a custom type descriptor.

GetDefaultEvent(Type) GetDefaultEvent(Type) GetDefaultEvent(Type) GetDefaultEvent(Type)

Restituisce l'evento predefinito per il tipo specificato di componente.Returns the default event for the specified type of component.

GetDefaultProperty(Object) GetDefaultProperty(Object) GetDefaultProperty(Object) GetDefaultProperty(Object)

Restituisce la proprietà predefinita per il componente specificato.Returns the default property for the specified component.

GetDefaultProperty(Object, Boolean) GetDefaultProperty(Object, Boolean) GetDefaultProperty(Object, Boolean) GetDefaultProperty(Object, Boolean)

Restituisce la proprietà predefinita per il componente specificato con un descrittore di tipi personalizzato.Returns the default property for the specified component with a custom type descriptor.

GetDefaultProperty(Type) GetDefaultProperty(Type) GetDefaultProperty(Type) GetDefaultProperty(Type)

Restituisce la proprietà predefinita per il tipo specificato di componente.Returns the default property for the specified type of component.

GetEditor(Object, Type) GetEditor(Object, Type) GetEditor(Object, Type) GetEditor(Object, Type)

Ottiene un editor con il tipo base specificato per il componente specificato.Gets an editor with the specified base type for the specified component.

GetEditor(Object, Type, Boolean) GetEditor(Object, Type, Boolean) GetEditor(Object, Type, Boolean) GetEditor(Object, Type, Boolean)

Restituisce un editor con il tipo base specificato e con un descrittore di tipi personalizzato per il componente specificato.Returns an editor with the specified base type and with a custom type descriptor for the specified component.

GetEditor(Type, Type) GetEditor(Type, Type) GetEditor(Type, Type) GetEditor(Type, Type)

Restituisce un editor con il tipo base specificato per il tipo specificato.Returns an editor with the specified base type for the specified type.

GetEvents(Object) GetEvents(Object) GetEvents(Object) GetEvents(Object)

Restituisce l'insieme degli eventi per il componente specificato.Returns the collection of events for the specified component.

GetEvents(Object, Attribute[]) GetEvents(Object, Attribute[]) GetEvents(Object, Attribute[]) GetEvents(Object, Attribute[])

Restituisce l'insieme di eventi per un componente specificato utilizzando come filtro una matrice di attributi specificata.Returns the collection of events for a specified component using a specified array of attributes as a filter.

GetEvents(Object, Attribute[], Boolean) GetEvents(Object, Attribute[], Boolean) GetEvents(Object, Attribute[], Boolean) GetEvents(Object, Attribute[], Boolean)

Restituisce l'insieme di eventi per un componente specificato utilizzando come filtro una matrice di attributi specificata e un descrittore di tipi personalizzato.Returns the collection of events for a specified component using a specified array of attributes as a filter and using a custom type descriptor.

GetEvents(Object, Boolean) GetEvents(Object, Boolean) GetEvents(Object, Boolean) GetEvents(Object, Boolean)

Restituisce l'insieme di eventi per un componente specificato con un descrittore di tipi personalizzato.Returns the collection of events for a specified component with a custom type descriptor.

GetEvents(Type) GetEvents(Type) GetEvents(Type) GetEvents(Type)

Restituisce l'insieme di eventi per un tipo specificato di componente.Returns the collection of events for a specified type of component.

GetEvents(Type, Attribute[]) GetEvents(Type, Attribute[]) GetEvents(Type, Attribute[]) GetEvents(Type, Attribute[])

Restituisce l'insieme di eventi per un tipo specificato di componente utilizzando come filtro una matrice di attributi specificata.Returns the collection of events for a specified type of component using a specified array of attributes as a filter.

GetFullComponentName(Object) GetFullComponentName(Object) GetFullComponentName(Object) GetFullComponentName(Object)

Restituisce il nome completo del componente.Returns the fully qualified name of the component.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetProperties(Object) GetProperties(Object) GetProperties(Object) GetProperties(Object)

Restituisce l'insieme di proprietà per un componente specificato.Returns the collection of properties for a specified component.

GetProperties(Object, Attribute[]) GetProperties(Object, Attribute[]) GetProperties(Object, Attribute[]) GetProperties(Object, Attribute[])

Restituisce l'insieme di proprietà per un componente specificato utilizzando come filtro una matrice di attributi specificata.Returns the collection of properties for a specified component using a specified array of attributes as a filter.

GetProperties(Object, Attribute[], Boolean) GetProperties(Object, Attribute[], Boolean) GetProperties(Object, Attribute[], Boolean) GetProperties(Object, Attribute[], Boolean)

Restituisce l'insieme di proprietà per un componente specificato utilizzando come filtro una matrice di attributi specificata e un descrittore di tipi personalizzato.Returns the collection of properties for a specified component using a specified array of attributes as a filter and using a custom type descriptor.

GetProperties(Object, Boolean) GetProperties(Object, Boolean) GetProperties(Object, Boolean) GetProperties(Object, Boolean)

Restituisce l'insieme di proprietà per un componente specificato utilizzando il descrittore di tipi personalizzato.Returns the collection of properties for a specified component using the default type descriptor.

GetProperties(Type) GetProperties(Type) GetProperties(Type) GetProperties(Type)

Restituisce l'insieme di proprietà per un tipo specificato di componente.Returns the collection of properties for a specified type of component.

GetProperties(Type, Attribute[]) GetProperties(Type, Attribute[]) GetProperties(Type, Attribute[]) GetProperties(Type, Attribute[])

Restituisce l'insieme di proprietà per un tipo specificato di componente utilizzando come filtro una matrice di attributi specificata.Returns the collection of properties for a specified type of component using a specified array of attributes as a filter.

GetProvider(Object) GetProvider(Object) GetProvider(Object) GetProvider(Object)

Restituisce il provider della descrizione del tipo per il componente specificato.Returns the type description provider for the specified component.

GetProvider(Type) GetProvider(Type) GetProvider(Type) GetProvider(Type)

Restituisce il provider della descrizione del tipo per il tipo specificato.Returns the type description provider for the specified type.

GetReflectionType(Object) GetReflectionType(Object) GetReflectionType(Object) GetReflectionType(Object)

Restituisce un oggetto Type che può essere utilizzato per effettuare la reflection, dato un oggetto.Returns a Type that can be used to perform reflection, given an object.

GetReflectionType(Type) GetReflectionType(Type) GetReflectionType(Type) GetReflectionType(Type)

Restituisce un oggetto Type che può essere utilizzato per effettuare la reflection, dato un tipo di classe.Returns a Type that can be used to perform reflection, given a class type.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
Refresh(Assembly) Refresh(Assembly) Refresh(Assembly) Refresh(Assembly)

Elimina dalla cache le proprietà e gli eventi per l'assembly specificato.Clears the properties and events for the specified assembly from the cache.

Refresh(Module) Refresh(Module) Refresh(Module) Refresh(Module)

Elimina dalla cache le proprietà e gli eventi per il modulo specificato.Clears the properties and events for the specified module from the cache.

Refresh(Object) Refresh(Object) Refresh(Object) Refresh(Object)

Elimina dalla cache le proprietà e gli eventi per il componente specificato.Clears the properties and events for the specified component from the cache.

Refresh(Type) Refresh(Type) Refresh(Type) Refresh(Type)

Elimina dalla cache le proprietà e gli eventi per il tipo specificato di componente.Clears the properties and events for the specified type of component from the cache.

RemoveAssociation(Object, Object) RemoveAssociation(Object, Object) RemoveAssociation(Object, Object) RemoveAssociation(Object, Object)

Rimuove un'associazione tra due oggetti.Removes an association between two objects.

RemoveAssociations(Object) RemoveAssociations(Object) RemoveAssociations(Object) RemoveAssociations(Object)

Rimuove tutte le associazioni di un oggetto primario.Removes all associations for a primary object.

RemoveProvider(TypeDescriptionProvider, Object) RemoveProvider(TypeDescriptionProvider, Object) RemoveProvider(TypeDescriptionProvider, Object) RemoveProvider(TypeDescriptionProvider, Object)

Rimuove un provider della descrizione del tipo aggiunto in precedenza e associato all'oggetto specificato.Removes a previously added type description provider that is associated with the specified object.

RemoveProvider(TypeDescriptionProvider, Type) RemoveProvider(TypeDescriptionProvider, Type) RemoveProvider(TypeDescriptionProvider, Type) RemoveProvider(TypeDescriptionProvider, Type)

Rimuove un provider della descrizione del tipo aggiunto in precedenza e associato al tipo specificato.Removes a previously added type description provider that is associated with the specified type.

RemoveProviderTransparent(TypeDescriptionProvider, Object) RemoveProviderTransparent(TypeDescriptionProvider, Object) RemoveProviderTransparent(TypeDescriptionProvider, Object) RemoveProviderTransparent(TypeDescriptionProvider, Object)

Rimuove un provider della descrizione del tipo aggiunto in precedenza e associato all'oggetto specificato.Removes a previously added type description provider that is associated with the specified object.

RemoveProviderTransparent(TypeDescriptionProvider, Type) RemoveProviderTransparent(TypeDescriptionProvider, Type) RemoveProviderTransparent(TypeDescriptionProvider, Type) RemoveProviderTransparent(TypeDescriptionProvider, Type)

Rimuove un provider della descrizione del tipo aggiunto in precedenza e associato al tipo specificato.Removes a previously added type description provider that is associated with the specified type.

SortDescriptorArray(IList) SortDescriptorArray(IList) SortDescriptorArray(IList) SortDescriptorArray(IList)

Ordina i descrittori utilizzando il nome del descrittore.Sorts descriptors using the name of the descriptor.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Eventi

Refreshed Refreshed Refreshed Refreshed

Viene generato quando viene svuotata la cache di un componente.Occurs when the cache for a component is cleared.

Si applica a

Vedi anche