TypeDescriptor Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zawiera informacje o cechach składnika, takich jak jego atrybuty, właściwości i zdarzenia. Tej klasy nie można dziedziczyć.
public ref class TypeDescriptor sealed
public sealed class TypeDescriptor
type TypeDescriptor = class
Public NotInheritable Class TypeDescriptor
- Dziedziczenie
-
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.
Przestarzałe.
Przestarzałe.
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. |
GetConverterFromRegisteredType(Object) |
Pobiera konwerter typów dla typu określonego składnika. |
GetConverterFromRegisteredType(Type) |
Pobiera konwerter typów dla określonego zarejestrowanego 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. |
GetEventsFromRegisteredType(Type) |
Pobiera 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. |
GetPropertiesFromRegisteredType(Object) |
Pobiera kolekcję właściwości dla określonego składnika. |
GetPropertiesFromRegisteredType(Type) |
Pobiera kolekcję właściwości dla określonego typu. |
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. |
RegisterType<T>() |
Rejestruje typ, aby mógł być używany przez dostawców opartych na odbiciu w przyciętych aplikacjach. |
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. |