TypeDescriptor Klasa

Definicja

Zawiera informacje o charakterystyce składnika, takie jak jego atrybuty, właściwości i zdarzenia.Provides information about the characteristics for a component, such as its attributes, properties, and events. Klasa ta nie może być dziedziczona.This class cannot be inherited.

public ref class TypeDescriptor sealed
public sealed class TypeDescriptor
type TypeDescriptor = class
Public NotInheritable Class TypeDescriptor
Dziedziczenie
TypeDescriptor

Uwagi

.NET Framework zapewnia dwa sposoby dostępu do metadanych na typie: interfejs API odbicia podany w System.Reflection przestrzeni nazw i TypeDescriptor Klasa.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. Odbicie jest ogólnym mechanizmem dostępnym dla wszystkich typów, ponieważ jego podstawa została ustanowiona w GetType metodzie Object klasy głównej.Reflection is a general mechanism available to all types because its foundation is established in the GetType method of the root Object class. Informacje zwracane dla typu nie są rozszerzalne, w tym przypadku nie można ich modyfikować po kompilacji typu docelowego.The information it returns for a type is not extensible, in that it cannot be modified after compilation of the target type. Aby uzyskać więcej informacji, zobacz tematy w obszarze odbicie.For more information, see the topics in Reflection.

W przeciwieństwie TypeDescriptor do programu jest rozszerzalnym mechanizmem inspekcji dla składników: te klasy, które implementują IComponent interfejs.In contrast, TypeDescriptor is an extensible inspection mechanism for components: those classes that implement the IComponent interface. W przeciwieństwie do odbicia, nie sprawdza metod.Unlike reflection, it does not inspect for methods. TypeDescriptor mogą być dynamicznie rozszerzane przez kilka usług dostępnych za pomocą składnika docelowego Site .TypeDescriptor can be dynamically extended by several services available through the target component's Site. W poniższej tabeli przedstawiono te usługi.The following table shows these services.

Nazwa usługiService name OpisDescription
IExtenderProvider Włącza inną klasę, taką jak ToolTip , aby zapewnić dodatkowe właściwości do składnika.Enables another class, such as ToolTip, to provide extra properties to a component.
ITypeDescriptorFilterService Umożliwia innemu obiektowi modyfikowanie standardowych metadanych, które są udostępniane przez składnik.Enables another object to modify the standard metadata that is exposed by a component.
ICustomTypeDescriptor Umożliwia klasy całkowite i dynamiczne określanie własnych metadanych, zastępując standardowy mechanizm inspekcji TypeDescriptor .Enables a class to completely and dynamically specify its own metadata, replacing the standard inspection mechanism of TypeDescriptor.

Rozszerzalność udostępniana przez TypeDescriptor program umożliwia reprezentację składnika w czasie projektowania, która różni się od rzeczywistej reprezentacji w czasie wykonywania, co ułatwia TypeDescriptor Tworzenie infrastruktury czasu projektowania.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.

Wszystkie metody w programie TypeDescriptorstatic .All the methods in TypeDescriptor are static. Nie można utworzyć wystąpienia tej klasy, a tej klasy nie można dziedziczyć.You cannot create an instance of this class, and this class cannot be inherited.

Można ustawić wartości właściwości i zdarzeń dwa różne sposoby: Określ je w klasie składnika lub zmień je w czasie projektowania.You can set property and event values two different ways: specify them in the component class or change them at design time. Ponieważ można ustawić te wartości na dwa sposoby, przeciążone metody TypeDescriptor mają dwa różne typy parametrów: typu klasy lub wystąpienia obiektu.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.

Gdy chcesz uzyskać dostęp do TypeDescriptor informacji i masz wystąpienie obiektu, użyj metody wywołującej składnik.When you want to access TypeDescriptor information and you have an instance of the object, use the method that calls for a component. Użyj metody, która wywołuje dla typu klasy tylko wtedy, gdy nie masz wystąpienia obiektu.Use the method that calls for the class type only when you do not have an instance of the object.

Właściwości i zdarzenia są buforowane przez TypeDescriptor szybkość.Properties and events are cached by TypeDescriptor for speed. Zazwyczaj są one stałe dla okresu istnienia obiektu.Typically, they are constant for the lifetime of an object. Jednak dostawcy rozszerzeń i projektanci mogą zmieniać zestaw właściwości obiektu.However, extender providers and designers can change the set of properties on an object. W takim przypadku Refresh należy wywołać metodę, aby zaktualizować pamięć podręczną.If this is the case, then the Refresh method must be called to update the cache.

Właściwości

ComNativeDescriptorHandler
Nieaktualne.
Nieaktualne.
Nieaktualne.

Pobiera lub ustawia dostawcę informacji o typie Component Object Model (COM) dla składnika docelowego.Gets or sets the provider for the Component Object Model (COM) type information for the target component.

ComObjectType

Pobiera typ obiektu Component Object Model (COM) reprezentowanego przez składnik docelowy.Gets the type of the Component Object Model (COM) object represented by the target component.

InterfaceType

Pobiera typ, który reprezentuje dostawcę opisu typu dla wszystkich typów interfejsów.Gets a type that represents a type description provider for all interface types.

Metody

AddAttributes(Object, Attribute[])

Dodaje atrybuty na poziomie klasy do docelowego wystąpienia składnika.Adds class-level attributes to the target component instance.

AddAttributes(Type, Attribute[])

Dodaje atrybuty na poziomie klasy do docelowego typu składnika.Adds class-level attributes to the target component type.

AddEditorTable(Type, Hashtable)

Dodaje tabelę edytora dla danego typu podstawowego edytora.Adds an editor table for the given editor base type.

AddProvider(TypeDescriptionProvider, Object)

Dodaje dostawcę opisu typu dla pojedynczego wystąpienia składnika.Adds a type description provider for a single instance of a component.

AddProvider(TypeDescriptionProvider, Type)

Dodaje dostawcę opisu typu dla klasy składnika.Adds a type description provider for a component class.

AddProviderTransparent(TypeDescriptionProvider, Object)

Dodaje dostawcę opisu typu dla pojedynczego wystąpienia składnika.Adds a type description provider for a single instance of a component.

AddProviderTransparent(TypeDescriptionProvider, Type)

Dodaje dostawcę opisu typu dla klasy składnika.Adds a type description provider for a component class.

CreateAssociation(Object, Object)

Tworzy skojarzenie podstawowe-pomocnicze między dwoma obiektami.Creates a primary-secondary association between two objects.

CreateDesigner(IComponent, Type)

Tworzy wystąpienie projektanta powiązane z określonym składnikiem i określonym typem projektanta.Creates an instance of the designer associated with the specified component and of the specified type of designer.

CreateEvent(Type, EventDescriptor, Attribute[])

Tworzy nowy deskryptor zdarzenia, który jest identyczny z istniejącym deskryptorem zdarzenia, gdy przeszedł istniejący EventDescriptor .Creates a new event descriptor that is identical to an existing event descriptor, when passed the existing EventDescriptor.

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

Tworzy nowy deskryptor zdarzenia, który jest identyczny z istniejącym deskryptorem zdarzenia przez dynamiczne generowanie informacji deskryptora z określonego zdarzenia w typie.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[])

Tworzy obiekt, który może zostać zastąpiony dla innego typu danych.Creates an object that can substitute for another data type.

CreateProperty(Type, PropertyDescriptor, Attribute[])

Tworzy nowy deskryptor właściwości z istniejącego deskryptora właściwości przy użyciu określonej PropertyDescriptor tablicy atrybutów istniejących i.Creates a new property descriptor from an existing property descriptor, using the specified existing PropertyDescriptor and attribute array.

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

Tworzy i dynamicznie wiąże deskryptor właściwości z typem przy użyciu określonej nazwy właściwości, typu i tablicy atrybutów.Creates and dynamically binds a property descriptor to a type, using the specified property name, type, and attribute array.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetAssociation(Type, Object)

Zwraca wystąpienie typu skojarzonego z określonym obiektem podstawowym.Returns an instance of the type associated with the specified primary object.

GetAttributes(Object)

Zwraca kolekcję atrybutów dla określonego składnika.Returns the collection of attributes for the specified component.

GetAttributes(Object, Boolean)

Zwraca kolekcję atrybutów dla określonego składnika i wartość logiczną wskazującą, że utworzono deskryptor typu niestandardowego.Returns a collection of attributes for the specified component and a Boolean indicating that a custom type descriptor has been created.

GetAttributes(Type)

Zwraca kolekcję atrybutów dla określonego typu składnika.Returns a collection of attributes for the specified type of component.

GetClassName(Object)

Zwraca nazwę klasy dla określonego składnika przy użyciu domyślnego deskryptora typu.Returns the name of the class for the specified component using the default type descriptor.

GetClassName(Object, Boolean)

Zwraca nazwę klasy dla określonego składnika przy użyciu niestandardowego deskryptora typu.Returns the name of the class for the specified component using a custom type descriptor.

GetClassName(Type)

Zwraca nazwę klasy określonego typu.Returns the name of the class for the specified type.

GetComponentName(Object)

Zwraca nazwę określonego składnika przy użyciu domyślnego deskryptora typu.Returns the name of the specified component using the default type descriptor.

GetComponentName(Object, Boolean)

Zwraca nazwę określonego składnika przy użyciu niestandardowego deskryptora typu.Returns the name of the specified component using a custom type descriptor.

GetConverter(Object)

Zwraca konwerter typu dla typu określonego składnika.Returns a type converter for the type of the specified component.

GetConverter(Object, Boolean)

Zwraca konwerter typu dla typu określonego składnika z deskryptorem typu niestandardowego.Returns a type converter for the type of the specified component with a custom type descriptor.

GetConverter(Type)

Zwraca konwerter typu dla określonego typu.Returns a type converter for the specified type.

GetDefaultEvent(Object)

Zwraca domyślne zdarzenie dla określonego składnika.Returns the default event for the specified component.

GetDefaultEvent(Object, Boolean)

Zwraca domyślne zdarzenie dla składnika z niestandardowym deskryptorem typu.Returns the default event for a component with a custom type descriptor.

GetDefaultEvent(Type)

Zwraca domyślne zdarzenie dla określonego typu składnika.Returns the default event for the specified type of component.

GetDefaultProperty(Object)

Zwraca domyślną właściwość określonego składnika.Returns the default property for the specified component.

GetDefaultProperty(Object, Boolean)

Zwraca domyślną właściwość dla określonego składnika z deskryptorem typu niestandardowego.Returns the default property for the specified component with a custom type descriptor.

GetDefaultProperty(Type)

Zwraca właściwość domyślną dla określonego typu składnika.Returns the default property for the specified type of component.

GetEditor(Object, Type)

Pobiera Edytor o określonym typie podstawowym dla określonego składnika.Gets an editor with the specified base type for the specified component.

GetEditor(Object, Type, Boolean)

Zwraca Edytor z określonym typem podstawowym i z deskryptorem typu niestandardowego dla określonego składnika.Returns an editor with the specified base type and with a custom type descriptor for the specified component.

GetEditor(Type, Type)

Zwraca Edytor o określonym typie podstawowym dla określonego typu.Returns an editor with the specified base type for the specified type.

GetEvents(Object)

Zwraca kolekcję zdarzeń dla określonego składnika.Returns the collection of events for the specified component.

GetEvents(Object, Attribute[])

Zwraca kolekcję zdarzeń dla określonego składnika przy użyciu określonej tablicy atrybutów jako filtru.Returns the collection of events for a specified component using a specified array of attributes as a filter.

GetEvents(Object, Attribute[], Boolean)

Zwraca kolekcję zdarzeń dla określonego składnika przy użyciu określonej tablicy atrybutów jako filtru i przy użyciu niestandardowego deskryptora typu.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)

Zwraca kolekcję zdarzeń dla określonego składnika z niestandardowym deskryptorem typu.Returns the collection of events for a specified component with a custom type descriptor.

GetEvents(Type)

Zwraca kolekcję zdarzeń dla określonego typu składnika.Returns the collection of events for a specified type of component.

GetEvents(Type, Attribute[])

Zwraca kolekcję zdarzeń dla określonego typu składnika przy użyciu określonej tablicy atrybutów jako filtru.Returns the collection of events for a specified type of component using a specified array of attributes as a filter.

GetFullComponentName(Object)

Zwraca w pełni kwalifikowaną nazwę składnika.Returns the fully qualified name of the component.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetProperties(Object)

Zwraca kolekcję właściwości określonego składnika.Returns the collection of properties for a specified component.

GetProperties(Object, Attribute[])

Zwraca kolekcję właściwości określonego składnika przy użyciu określonej tablicy atrybutów jako filtru.Returns the collection of properties for a specified component using a specified array of attributes as a filter.

GetProperties(Object, Attribute[], Boolean)

Zwraca kolekcję właściwości określonego składnika przy użyciu określonej tablicy atrybutów jako filtru i przy użyciu niestandardowego deskryptora typu.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)

Zwraca kolekcję właściwości określonego składnika przy użyciu domyślnego deskryptora typu.Returns the collection of properties for a specified component using the default type descriptor.

GetProperties(Type)

Zwraca kolekcję właściwości określonego typu składnika.Returns the collection of properties for a specified type of component.

GetProperties(Type, Attribute[])

Zwraca kolekcję właściwości określonego typu składnika przy użyciu określonej tablicy atrybutów jako filtru.Returns the collection of properties for a specified type of component using a specified array of attributes as a filter.

GetProvider(Object)

Zwraca dostawcę opisu typu dla określonego składnika.Returns the type description provider for the specified component.

GetProvider(Type)

Zwraca dostawcę opisu typu dla określonego typu.Returns the type description provider for the specified type.

GetReflectionType(Object)

Zwraca wartość, Type która może być używana do wykonywania odbicia, z uwzględnieniem obiektu.Returns a Type that can be used to perform reflection, given an object.

GetReflectionType(Type)

Zwraca wartość, Type która może być użyta do wykonania odbicia, z uwzględnieniem typu klasy.Returns a Type that can be used to perform reflection, given a class type.

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Refresh(Assembly)

Czyści właściwości i zdarzenia dla określonego zestawu z pamięci podręcznej.Clears the properties and events for the specified assembly from the cache.

Refresh(Module)

Czyści właściwości i zdarzenia dla określonego modułu z pamięci podręcznej.Clears the properties and events for the specified module from the cache.

Refresh(Object)

Czyści właściwości i zdarzenia dla określonego składnika z pamięci podręcznej.Clears the properties and events for the specified component from the cache.

Refresh(Type)

Czyści właściwości i zdarzenia dla określonego typu składnika z pamięci podręcznej.Clears the properties and events for the specified type of component from the cache.

RemoveAssociation(Object, Object)

Usuwa skojarzenie między dwoma obiektami.Removes an association between two objects.

RemoveAssociations(Object)

Usuwa wszystkie skojarzenia dla obiektu głównego.Removes all associations for a primary object.

RemoveProvider(TypeDescriptionProvider, Object)

Usuwa wcześniej dodany dostawca opisu typu, który jest skojarzony z określonym obiektem.Removes a previously added type description provider that is associated with the specified object.

RemoveProvider(TypeDescriptionProvider, Type)

Usuwa wcześniej dodany dostawca opisu typu, który jest skojarzony z określonym typem.Removes a previously added type description provider that is associated with the specified type.

RemoveProviderTransparent(TypeDescriptionProvider, Object)

Usuwa wcześniej dodany dostawca opisu typu, który jest skojarzony z określonym obiektem.Removes a previously added type description provider that is associated with the specified object.

RemoveProviderTransparent(TypeDescriptionProvider, Type)

Usuwa wcześniej dodany dostawca opisu typu, który jest skojarzony z określonym typem.Removes a previously added type description provider that is associated with the specified type.

SortDescriptorArray(IList)

Sortuje deskryptory przy użyciu nazwy deskryptora.Sorts descriptors using the name of the descriptor.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Zdarzenia

Refreshed

Występuje po wyczyszczeniu pamięci podręcznej składnika.Occurs when the cache for a component is cleared.

Dotyczy

Zobacz też