TypeDescriptor Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel

Zestaw:

System.ComponentModel.TypeConverter.dll

Źródło:

TypeDescriptor.cs

Zawiera informacje o cechach składnika, takich jak jego atrybuty, właściwości i zdarzenia. Tej klasy nie można dziedziczyć.

C#

public sealed class TypeDescriptor

Dziedziczenie

Object

TypeDescriptor

Uwagi

Program .NET Framework zapewnia dwa sposoby uzyskiwania dostępu do metadanych typu: interfejs API odbicia podany w przestrzeni nazw System.Reflection oraz klasę TypeDescriptor. Odbicie jest ogólnym mechanizmem dostępnym dla wszystkich typów, ponieważ jego podstawa jest ustanowiona w metodzie GetType klasy Object głównej. Informacje zwracane dla typu nie są rozszerzalne, ponieważ nie można go modyfikować po kompilacji typu docelowego. Aby uzyskać więcej informacji, zobacz tematy w temacie Odbicie.

Natomiast TypeDescriptor jest rozszerzalnym mechanizmem inspekcji dla składników: tych klas, które implementują interfejs IComponent. W przeciwieństwie do odbicia, nie sprawdza metod. TypeDescriptor można dynamicznie rozszerzać przez kilka usług dostępnych za pośrednictwem Siteskładnika docelowego. W poniższej tabeli przedstawiono te usługi.

Nazwa usługi	Opis
IExtenderProvider	Umożliwia inną klasę, taką jak ToolTip, w celu zapewnienia dodatkowych właściwości składnikowi.
ITypeDescriptorFilterService	Umożliwia innemu obiektowi modyfikowanie standardowych metadanych udostępnianych przez składnik.
ICustomTypeDescriptor	Umożliwia klasie całkowite i dynamiczne określanie własnych metadanych, zastępując standardowy mechanizm inspekcji TypeDescriptor.

Rozszerzalność zapewniana przez TypeDescriptor umożliwia reprezentację składnika w czasie projektowania różni się od rzeczywistej reprezentacji czasu wykonywania, co sprawia, że TypeDescriptor przydatne do tworzenia infrastruktury czasu projektowania.

Wszystkie metody w TypeDescriptor są static. Nie można utworzyć wystąpienia tej klasy i tej klasy nie można dziedziczyć.

Możesz ustawić właściwości i wartości zdarzeń na dwa różne sposoby: określić je w klasie składnika lub zmienić je w czasie projektowania. Ponieważ można ustawić te wartości na dwa sposoby, przeciążone metody TypeDescriptor przyjmują dwa różne typy parametrów: typ klasy lub wystąpienie obiektu.

Jeśli chcesz uzyskać dostęp do TypeDescriptor informacji i masz wystąpienie obiektu, użyj metody, która wywołuje składnik. Użyj metody, która wywołuje typ klasy tylko wtedy, gdy nie masz wystąpienia obiektu.

Właściwości i zdarzenia są buforowane przez TypeDescriptor w celu uzyskania szybkości. Zazwyczaj są one stałe przez cały okres istnienia obiektu. Jednak dostawcy rozszerzeń i projektanci mogą zmieniać zestaw właściwości obiektu. W takim przypadku należy wywołać metodę Refresh w celu zaktualizowania pamięci podręcznej.

Właściwości

ComNativeDescriptorHandler	Przestarzałe. Pobiera lub ustawia dostawcę informacji o typie modelu obiektów składników (COM) dla składnika docelowego.
ComObjectType	Pobiera typ obiektu Component Object Model (COM) reprezentowanego przez składnik docelowy.
InterfaceType	Pobiera typ reprezentujący dostawcę opisu typu dla wszystkich typów interfejsów.

Metody

AddAttributes(Object, Attribute[])	Dodaje atrybuty na poziomie klasy do wystąpienia składnika docelowego.
AddAttributes(Type, Attribute[])	Dodaje atrybuty na poziomie klasy do docelowego typu składnika.
AddEditorTable(Type, Hashtable)	Dodaje tabelę edytora dla danego typu podstawowego edytora.
AddProvider(TypeDescriptionProvider, Object)	Dodaje dostawcę opisu typu dla pojedynczego wystąpienia składnika.
AddProvider(TypeDescriptionProvider, Type)	Dodaje dostawcę opisu typu dla klasy składnika.
AddProviderTransparent(TypeDescriptionProvider, Object)	Dodaje dostawcę opisu typu dla pojedynczego wystąpienia składnika.
AddProviderTransparent(TypeDescriptionProvider, Type)	Dodaje dostawcę opisu typu dla klasy składnika.
CreateAssociation(Object, Object)	Tworzy skojarzenie pomocnicze podstawowe między dwoma obiektami.
CreateDesigner(IComponent, Type)	Tworzy wystąpienie projektanta skojarzone z określonym składnikiem i określonego typu projektanta.
CreateEvent(Type, EventDescriptor, Attribute[])	Tworzy nowy deskryptor zdarzeń, który jest identyczny z istniejącym deskryptorem zdarzeń po przekazaniu istniejącej EventDescriptor.
CreateEvent(Type, String, Type, Attribute[])	Tworzy nowy deskryptor zdarzeń, który jest identyczny z istniejącym deskryptorem zdarzeń, dynamicznie generując informacje deskryptora z określonego zdarzenia na typie.
CreateInstance(IServiceProvider, Type, Type[], Object[])	Tworzy obiekt, który może zastąpić inny typ danych.
CreateProperty(Type, PropertyDescriptor, Attribute[])	Tworzy nowy deskryptor właściwości na podstawie istniejącego deskryptora właściwości przy użyciu określonej istniejącej tablicy PropertyDescriptor i atrybutów.
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.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetAssociation(Type, Object)	Zwraca wystąpienie typu skojarzonego z określonym obiektem podstawowym.
GetAttributes(Object, Boolean)	Zwraca kolekcję atrybutów dla określonego składnika i wartość logiczną wskazującą, że został utworzony deskryptor niestandardowego typu.
GetAttributes(Object)	Zwraca kolekcję atrybutów dla określonego składnika.
GetAttributes(Type)	Zwraca kolekcję atrybutów dla określonego typu składnika.
GetClassName(Object, Boolean)	Zwraca nazwę klasy dla określonego składnika przy użyciu deskryptora niestandardowego typu.
GetClassName(Object)	Zwraca nazwę klasy dla określonego składnika przy użyciu deskryptora domyślnego typu.
GetClassName(Type)	Zwraca nazwę klasy dla określonego typu.
GetComponentName(Object, Boolean)	Zwraca nazwę określonego składnika przy użyciu deskryptora niestandardowego typu.
GetComponentName(Object)	Zwraca nazwę określonego składnika przy użyciu deskryptora domyślnego typu.
GetConverter(Object, Boolean)	Zwraca konwerter typów dla typu określonego składnika z deskryptorem niestandardowego typu.
GetConverter(Object)	Zwraca konwerter typów dla typu określonego składnika.
GetConverter(Type)	Zwraca konwerter typów dla określonego typu.
GetDefaultEvent(Object, Boolean)	Zwraca zdarzenie domyślne składnika z deskryptorem niestandardowego typu.
GetDefaultEvent(Object)	Zwraca zdarzenie domyślne dla określonego składnika.
GetDefaultEvent(Type)	Zwraca zdarzenie domyślne określonego typu składnika.
GetDefaultProperty(Object, Boolean)	Zwraca właściwość domyślną dla określonego składnika z deskryptorem niestandardowego typu.
GetDefaultProperty(Object)	Zwraca właściwość domyślną dla określonego składnika.
GetDefaultProperty(Type)	Zwraca właściwość domyślną dla określonego typu składnika.
GetEditor(Object, Type, Boolean)	Zwraca edytor z określonym typem podstawowym i deskryptorem niestandardowego typu dla określonego składnika.
GetEditor(Object, Type)	Pobiera edytor z określonym typem podstawowym dla określonego składnika.
GetEditor(Type, Type)	Zwraca edytor o określonym typie podstawowym dla określonego typu.
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 typów.
GetEvents(Object, Attribute[])	Zwraca kolekcję zdarzeń dla określonego składnika przy użyciu określonej tablicy atrybutów jako filtru.
GetEvents(Object, Boolean)	Zwraca kolekcję zdarzeń dla określonego składnika z deskryptorem niestandardowego typu.
GetEvents(Object)	Zwraca kolekcję zdarzeń dla określonego składnika.
GetEvents(Type, Attribute[])	Zwraca kolekcję zdarzeń dla określonego typu składnika przy użyciu określonej tablicy atrybutów jako filtru.
GetEvents(Type)	Zwraca kolekcję zdarzeń dla określonego typu składnika.
GetFullComponentName(Object)	Zwraca w pełni kwalifikowaną nazwę składnika.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetProperties(Object, Attribute[], Boolean)	Zwraca kolekcję właściwości dla określonego składnika przy użyciu określonej tablicy atrybutów jako filtru i przy użyciu deskryptora niestandardowego typu.
GetProperties(Object, Attribute[])	Zwraca kolekcję właściwości dla określonego składnika przy użyciu określonej tablicy atrybutów jako filtru.
GetProperties(Object, Boolean)	Zwraca kolekcję właściwości dla określonego składnika przy użyciu deskryptora domyślnego typu.
GetProperties(Object)	Zwraca kolekcję właściwości dla określonego składnika.
GetProperties(Type, Attribute[])	Zwraca kolekcję właściwości określonego typu składnika przy użyciu określonej tablicy atrybutów jako filtru.
GetProperties(Type)	Zwraca kolekcję właściwości dla określonego typu składnika.
GetProvider(Object)	Zwraca dostawcę opisu typu dla określonego składnika.
GetProvider(Type)	Zwraca dostawcę opisu typu dla określonego typu.
GetReflectionType(Object)	Zwraca Type, które mogą służyć do odbicia, biorąc pod uwagę obiekt.
GetReflectionType(Type)	Zwraca Type, które mogą służyć do odbicia, biorąc pod uwagę typ klasy.
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
Refresh(Assembly)	Czyści właściwości i zdarzenia dla określonego zestawu z pamięci podręcznej.
Refresh(Module)	Czyści właściwości i zdarzenia dla określonego modułu z pamięci podręcznej.
Refresh(Object)	Czyści właściwości i zdarzenia dla określonego składnika z pamięci podręcznej.
Refresh(Type)	Czyści właściwości i zdarzenia określonego typu składnika z pamięci podręcznej.
RemoveAssociation(Object, Object)	Usuwa skojarzenie między dwoma obiektami.
RemoveAssociations(Object)	Usuwa wszystkie skojarzenia dla obiektu podstawowego.
RemoveProvider(TypeDescriptionProvider, Object)	Usuwa wcześniej dodanego dostawcę opisu typu skojarzonego z określonym obiektem.
RemoveProvider(TypeDescriptionProvider, Type)	Usuwa wcześniej dodanego dostawcę opisu typu skojarzonego z określonym typem.
RemoveProviderTransparent(TypeDescriptionProvider, Object)	Usuwa wcześniej dodanego dostawcę opisu typu skojarzonego z określonym obiektem.
RemoveProviderTransparent(TypeDescriptionProvider, Type)	Usuwa wcześniej dodanego dostawcę opisu typu skojarzonego z określonym typem.
SortDescriptorArray(IList)	Sortuje deskryptory przy użyciu nazwy deskryptora.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

Refreshed

Występuje, gdy pamięć podręczna składnika jest czyszczone.

Dotyczy

Zobacz też

• EventDescriptor
• PropertyDescriptor
• System.Reflection
• IComponent
• ISite
• Deskryptor typów — omówienie
• odbicie