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. Klasa ta nie może być dziedziczona.
public ref class TypeDescriptor sealed
public sealed class TypeDescriptor
type TypeDescriptor = class
Public NotInheritable Class TypeDescriptor
- Dziedziczenie
-
TypeDescriptor
Uwagi
.NET Framework zapewnia dwa sposoby uzyskiwania dostępu do metadanych dla typu: interfejs API odbicia podany w System.Reflection przestrzeni nazw i klasęTypeDescriptor. Odbicie jest ogólnym mechanizmem dostępnym dla wszystkich typów, ponieważ jego podstawa jest ustanowiona w GetType metodzie klasy głównej Object . 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 sekcji Odbicie.
Natomiast jest TypeDescriptor rozszerzalnym mechanizmem inspekcji składników: tych klas, które implementują IComponent interfejs. W przeciwieństwie do odbicia, nie sprawdza metod. TypeDescriptor Może być dynamicznie rozszerzany przez kilka usług dostępnych za pośrednictwem składnika Sitedocelowego . W poniższej tabeli przedstawiono te usługi.
| Nazwa usługi | Opis |
|---|---|
| IExtenderProvider | Włącza inną klasę, taką jak ToolTip, w celu zapewnienia dodatkowych właściwości składnika. |
| ITypeDescriptorFilterService | Umożliwia innemu obiektowi modyfikowanie standardowych metadanych uwidocznionych przez składnik. |
| ICustomTypeDescriptor | Umożliwia klasie całkowite i dynamiczne określanie własnych metadanych, zastępując standardowy mechanizm inspekcji klasy TypeDescriptor. |
Rozszerzalność zapewniana przez TypeDescriptor program umożliwia reprezentację składnika w czasie projektowania różni się od rzeczywistej reprezentacji w czasie wykonywania, co ułatwia TypeDescriptor tworzenie infrastruktury w czasie projektowania.
Wszystkie metody w TypeDescriptor pliku to static. Nie można utworzyć wystąpienia tej klasy i tej klasy nie można dziedziczyć.
Można 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ż te wartości można ustawić 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 wywołującej 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 szybkość. Zazwyczaj są one stałe przez cały okres istnienia obiektu. Jednak dostawcy rozszerzeń i projektanci mogą zmieniać zestaw właściwości obiektu. Jeśli tak jest, należy wywołać metodę Refresh , aby zaktualizować pamięć podręczną.
Właściwości
| ComNativeDescriptorHandler |
Nieaktualne.
Nieaktualne.
Nieaktualne.
Nieaktualne.
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 typu składnika docelowego. |
| 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 skojarzonego 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ącego EventDescriptordeskryptora zdarzeń. |
| 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 z istniejącego deskryptora właściwości przy użyciu określonej istniejącej PropertyDescriptor tablicy atrybutów i. |
| 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 dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| GetAssociation(Type, Object) |
Zwraca wystąpienie typu skojarzonego z określonym obiektem podstawowym. |
| GetAttributes(Object) |
Zwraca kolekcję atrybutów dla określonego składnika. |
| GetAttributes(Object, Boolean) |
Zwraca kolekcję atrybutów dla określonego składnika i wartość logiczną wskazującą, że został utworzony niestandardowy deskryptor typów. |
| GetAttributes(Type) |
Zwraca kolekcję atrybutów dla określonego typu składnika. |
| GetClassName(Object) |
Zwraca nazwę klasy dla określonego składnika przy użyciu deskryptora domyślnego typu. |
| GetClassName(Object, Boolean) |
Zwraca nazwę klasy dla określonego składnika przy użyciu deskryptora niestandardowego typu. |
| GetClassName(Type) |
Zwraca nazwę klasy dla określonego typu. |
| GetComponentName(Object) |
Zwraca nazwę określonego składnika przy użyciu deskryptora domyślnego typu. |
| GetComponentName(Object, Boolean) |
Zwraca nazwę określonego składnika przy użyciu deskryptora niestandardowego typu. |
| GetConverter(Object) |
Zwraca konwerter typów dla typu określonego składnika. |
| GetConverter(Object, Boolean) |
Zwraca konwerter typów dla typu określonego składnika z deskryptorem typu niestandardowego. |
| GetConverter(Type) |
Zwraca konwerter typów dla określonego typu. |
| GetDefaultEvent(Object) |
Zwraca domyślne zdarzenie dla określonego składnika. |
| GetDefaultEvent(Object, Boolean) |
Zwraca domyślne zdarzenie składnika z deskryptorem niestandardowego typu. |
| GetDefaultEvent(Type) |
Zwraca zdarzenie domyślne dla określonego typu składnika. |
| GetDefaultProperty(Object) |
Zwraca właściwość domyślną dla określonego składnika. |
| GetDefaultProperty(Object, Boolean) |
Zwraca właściwość domyślną dla określonego składnika z deskryptorem niestandardowego typu. |
| GetDefaultProperty(Type) |
Zwraca właściwość domyślną dla określonego typu składnika. |
| GetEditor(Object, Type) |
Pobiera edytor z określonym typem podstawowym dla określonego składnika. |
| GetEditor(Object, Type, Boolean) |
Zwraca edytor z określonym typem podstawowym i deskryptorem niestandardowego typu dla określonego składnika. |
| GetEditor(Type, Type) |
Zwraca edytor z określonym typem podstawowym dla określonego typu. |
| GetEvents(Object) |
Zwraca kolekcję zdarzeń dla określonego składnika. |
| GetEvents(Object, Attribute[]) |
Zwraca kolekcję zdarzeń dla określonego składnika przy użyciu określonej tablicy atrybutów jako filtru. |
| 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 deskryptora niestandardowego typu. |
| GetEvents(Object, Boolean) |
Zwraca kolekcję zdarzeń dla określonego składnika z deskryptorem niestandardowego typu. |
| GetEvents(Type) |
Zwraca kolekcję zdarzeń dla określonego typu składnika. |
| GetEvents(Type, Attribute[]) |
Zwraca kolekcję zdarzeń dla określonego typu składnika przy użyciu określonej tablicy atrybutów jako filtru. |
| 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) |
Zwraca kolekcję właściwości dla określonego składnika. |
| 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, 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, Boolean) |
Zwraca kolekcję właściwości dla określonego składnika przy użyciu deskryptora domyślnego typu. |
| GetProperties(Type) |
Zwraca kolekcję właściwości dla określonego typu 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. |
| GetProvider(Object) |
Zwraca dostawcę opisu typu dla określonego składnika. |
| GetProvider(Type) |
Zwraca dostawcę opisu typu dla określonego typu. |
| GetReflectionType(Object) |
Zwraca obiekt Type , który może służyć do odbicia, biorąc pod uwagę obiekt. |
| GetReflectionType(Type) |
Zwraca wartość Type , która może służyć do odbicia, biorąc pod uwagę typ klasy. |
| GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (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 dla 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, który jest skojarzony z określonym obiektem. |
| RemoveProvider(TypeDescriptionProvider, Type) |
Usuwa wcześniej dodanego dostawcę opisu typu, który jest skojarzony z określonym typem. |
| RemoveProviderTransparent(TypeDescriptionProvider, Object) |
Usuwa wcześniej dodanego dostawcę opisu typu, który jest skojarzony z określonym obiektem. |
| RemoveProviderTransparent(TypeDescriptionProvider, Type) |
Usuwa wcześniej dodanego dostawcę opisu typu, który jest skojarzony 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. |