TypeDescriptor Sınıf

Tanım

Ad Alanı:

System.ComponentModel

Bütünleştirilmiş Kodlar:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Kaynak:

TypeDescriptor.cs

Bir bileşenin öznitelikleri, özellikleri ve olayları gibi özellikleri hakkında bilgi sağlar. Bu sınıf devralınamaz.

public ref class TypeDescriptor sealed

public sealed class TypeDescriptor

type TypeDescriptor = class

Public NotInheritable Class TypeDescriptor

Devralma

Object

TypeDescriptor

Açıklamalar

.NET Framework, bir türdeki meta verilere erişmek için iki yol sağlar: System.Reflection ad alanında sağlanan yansıma API'si ve TypeDescriptor sınıfı. Temeli kök Object sınıfın yönteminde GetType oluşturulduğundan yansıma, tüm türler için kullanılabilen genel bir mekanizmadır. Bir tür için döndürdüğü bilgiler, hedef türün derlenmesinden sonra değiştirilemeyeceği için genişletilebilir değildir. Daha fazla bilgi için Yansıma'daki konulara bakın.

Buna karşılık, TypeDescriptor bileşenler için genişletilebilir bir denetim mekanizmasıdır: arabirimi uygulayan IComponent sınıflar. Yansımadan farklı olarak, yöntemler için inceleme yapmaz. TypeDescriptor hedef bileşenin Sitearacılığıyla kullanılabilen çeşitli hizmetler tarafından dinamik olarak genişletilebilir. Aşağıdaki tabloda bu hizmetler gösterilmektedir.

Hizmet adı	Açıklama
IExtenderProvider	Bir bileşene ek özellikler sağlamak için gibi ToolTipbaşka bir sınıfı etkinleştirir.
ITypeDescriptorFilterService	Başka bir nesnenin bir bileşen tarafından kullanıma sunulan standart meta verileri değiştirmesini sağlar.
ICustomTypeDescriptor	Sınıfın kendi meta verilerini tamamen ve dinamik olarak belirtmesini sağlar ve standart denetim mekanizmasının TypeDescriptoryerini alır.

tarafından TypeDescriptor sağlanan genişletilebilirlik, bir bileşenin tasarım zamanı gösteriminin gerçek çalışma zamanı gösteriminden farklı olmasını sağlar ve bu da tasarım zamanı altyapısı oluşturmak için yararlı olur TypeDescriptor .

içindeki TypeDescriptor tüm yöntemler şeklindedir static. Bu sınıfın bir örneğini oluşturamazsınız ve bu sınıf devralınamaz.

Özellik ve olay değerlerini iki farklı şekilde ayarlayabilirsiniz: bunları bileşen sınıfında belirtebilir veya tasarım zamanında değiştirebilirsiniz. Bu değerleri iki şekilde ayarlayabildiğiniz için, aşırı yüklenmiş yöntemleri TypeDescriptor iki farklı parametre türü alır: sınıf türü veya nesne örneği.

Bilgilere erişmek TypeDescriptor istediğinizde ve nesnesinin bir örneğine sahipseniz, bileşen için çağıran yöntemini kullanın. Sınıf türü için çağıran yöntemini yalnızca nesnenin bir örneğine sahip olmadığınızda kullanın.

Özellikler ve olaylar tarafından hız için önbelleğe alınır TypeDescriptor . Genellikle, bir nesnenin ömrü boyunca sabittir. Ancak, genişletici sağlayıcıları ve tasarımcıları bir nesnedeki özellik kümesini değiştirebilir. Bu durumda, Refresh önbelleği güncelleştirmek için yöntemi çağrılmalıdır.

Özellikler

Name	Description
ComNativeDescriptorHandler	Geçersiz. Hedef bileşen için Bileşen Nesne Modeli (COM) türü bilgilerini alır veya ayarlar.
ComObjectType	Hedef bileşen tarafından temsil edilen Bileşen Nesne Modeli (COM) nesnesinin türünü alır.
InterfaceType	Tüm arabirim türleri için tür açıklaması sağlayıcısını temsil eden bir tür alır.

Yöntemler

Name	Description
AddAttributes(Object, Attribute[])	Hedef bileşen örneğine sınıf düzeyi öznitelikleri ekler.
AddAttributes(Type, Attribute[])	Hedef bileşen türüne sınıf düzeyi öznitelikleri ekler.
AddEditorTable(Type, Hashtable)	Verilen düzenleyici temel türü için bir düzenleyici tablosu ekler.
AddProvider(TypeDescriptionProvider, Object)	Bir bileşenin tek bir örneği için tür açıklaması sağlayıcısı ekler.
AddProvider(TypeDescriptionProvider, Type)	Bileşen sınıfı için bir tür açıklaması sağlayıcısı ekler.
AddProviderTransparent(TypeDescriptionProvider, Object)	Bir bileşenin tek bir örneği için tür açıklaması sağlayıcısı ekler.
AddProviderTransparent(TypeDescriptionProvider, Type)	Bileşen sınıfı için bir tür açıklaması sağlayıcısı ekler.
CreateAssociation(Object, Object)	İki nesne arasında birincil-ikincil ilişki oluşturur.
CreateDesigner(IComponent, Type)	Belirtilen bileşenle ve belirtilen tasarımcı türüyle ilişkilendirilmiş tasarımcının bir örneğini oluşturur.
CreateEvent(Type, EventDescriptor, Attribute[])	Mevcut olay tanımlayıcısı geçirildiğinde, mevcut olay tanımlayıcısı ile aynı olan yeni bir olay tanımlayıcısı EventDescriptoroluşturur.
CreateEvent(Type, String, Type, Attribute[])	Bir türdeki belirtilen olaydan dinamik olarak tanımlayıcı bilgileri oluşturarak mevcut olay tanımlayıcısı ile aynı olan yeni bir olay tanımlayıcısı oluşturur.
CreateInstance(IServiceProvider, Type, Type[], Object[])	Başka bir veri türüyle değiştirilebilen bir nesne oluşturur.
CreateProperty(Type, PropertyDescriptor, Attribute[])	Belirtilen PropertyDescriptor mevcut ve öznitelik dizisini kullanarak var olan bir özellik tanımlayıcısından yeni bir özellik tanımlayıcısı oluşturur.
CreateProperty(Type, String, Type, Attribute[])	Belirtilen özellik adını, türünü ve öznitelik dizisini kullanarak bir özellik tanımlayıcısı oluşturur ve bir türe dinamik olarak bağlar.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetAssociation(Type, Object)	Belirtilen birincil nesneyle ilişkili türün bir örneğini döndürür.
GetAttributes(Object, Boolean)	Belirtilen bileşen için bir öznitelik koleksiyonu ve özel tür tanımlayıcısının oluşturulduğunu belirten bir Boole değeri döndürür.
GetAttributes(Object)	Belirtilen bileşen için öznitelik koleksiyonunu döndürür.
GetAttributes(Type)	Belirtilen bileşen türü için bir öznitelik koleksiyonu döndürür.
GetClassName(Object, Boolean)	Özel bir tür tanımlayıcısı kullanarak belirtilen bileşen için sınıfın adını döndürür.
GetClassName(Object)	Varsayılan tür tanımlayıcısını kullanarak belirtilen bileşen için sınıfın adını döndürür.
GetClassName(Type)	Belirtilen tür için sınıfın adını döndürür.
GetComponentName(Object, Boolean)	Özel bir tür tanımlayıcısı kullanarak belirtilen bileşenin adını döndürür.
GetComponentName(Object)	Varsayılan tür tanımlayıcısını kullanarak belirtilen bileşenin adını döndürür.
GetConverter(Object, Boolean)	Özel tür tanımlayıcısı ile belirtilen bileşenin türü için bir tür dönüştürücü döndürür.
GetConverter(Object)	Belirtilen bileşenin türü için bir tür dönüştürücüsü döndürür.
GetConverter(Type)	Belirtilen tür için bir tür dönüştürücü döndürür.
GetConverterFromRegisteredType(Object)	Belirtilen bileşenin türü için bir tür dönüştürücüsü alır.
GetConverterFromRegisteredType(Type)	Belirtilen kayıtlı tür için bir tür dönüştürücü alır.
GetDefaultEvent(Object, Boolean)	Özel tür tanımlayıcısı olan bir bileşen için varsayılan olayı döndürür.
GetDefaultEvent(Object)	Belirtilen bileşen için varsayılan olayı döndürür.
GetDefaultEvent(Type)	Belirtilen bileşen türü için varsayılan olayı döndürür.
GetDefaultProperty(Object, Boolean)	Özel tür tanımlayıcısı ile belirtilen bileşen için varsayılan özelliği döndürür.
GetDefaultProperty(Object)	Belirtilen bileşen için varsayılan özelliği döndürür.
GetDefaultProperty(Type)	Belirtilen bileşen türü için varsayılan özelliği döndürür.
GetEditor(Object, Type, Boolean)	Belirtilen temel türe ve belirtilen bileşen için özel tür tanımlayıcıya sahip bir düzenleyici döndürür.
GetEditor(Object, Type)	Belirtilen bileşen için belirtilen temel türe sahip bir düzenleyici alır.
GetEditor(Type, Type)	Belirtilen tür için belirtilen temel türe sahip bir düzenleyici döndürür.
GetEvents(Object, Attribute[], Boolean)	Belirtilen öznitelik dizisini filtre olarak ve özel tür tanımlayıcısı kullanarak belirtilen bir bileşen için olay koleksiyonunu döndürür.
GetEvents(Object, Attribute[])	Belirtilen öznitelik dizisini filtre olarak kullanarak belirtilen bir bileşen için olay koleksiyonunu döndürür.
GetEvents(Object, Boolean)	Özel tür tanımlayıcısı ile belirtilen bir bileşen için olay koleksiyonunu döndürür.
GetEvents(Object)	Belirtilen bileşen için olay koleksiyonunu döndürür.
GetEvents(Type, Attribute[])	Belirtilen öznitelik dizisini filtre olarak kullanarak belirtilen bileşen türü için olay koleksiyonunu döndürür.
GetEvents(Type)	Belirtilen bileşen türü için olay koleksiyonunu döndürür.
GetEventsFromRegisteredType(Type)	Belirtilen bileşen türü için olay koleksiyonunu alır.
GetFullComponentName(Object)	Bileşenin tam adını döndürür.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetProperties(Object, Attribute[], Boolean)	Belirtilen öznitelik dizisini filtre olarak ve özel tür tanımlayıcısı kullanarak belirtilen bir bileşen için özellik koleksiyonunu döndürür.
GetProperties(Object, Attribute[])	Belirtilen öznitelik dizisini filtre olarak kullanarak belirtilen bir bileşen için özellik koleksiyonunu döndürür.
GetProperties(Object, Boolean)	Varsayılan tür tanımlayıcısını kullanarak belirtilen bir bileşenin özellik koleksiyonunu döndürür.
GetProperties(Object)	Belirtilen bileşen için özellik koleksiyonunu döndürür.
GetProperties(Type, Attribute[])	Belirtilen öznitelik dizisini filtre olarak kullanarak belirtilen bileşen türü için özellik koleksiyonunu döndürür.
GetProperties(Type)	Belirtilen bileşen türü için özellik koleksiyonunu döndürür.
GetPropertiesFromRegisteredType(Object)	Belirtilen bileşen için bir özellik koleksiyonu alır.
GetPropertiesFromRegisteredType(Type)	Belirtilen tür için bir özellik koleksiyonu alır.
GetProvider(Object)	Belirtilen bileşen için tür açıklaması sağlayıcısını döndürür.
GetProvider(Type)	Belirtilen tür için tür açıklaması sağlayıcısını döndürür.
GetReflectionType(Object)	Nesne Type verilip yansıma gerçekleştirmek için kullanılabilecek bir döndürür.
GetReflectionType(Type)	Type Bir sınıf türü verilip yansıma gerçekleştirmek için kullanılabilecek bir döndürür.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
Refresh(Assembly)	Belirtilen derlemenin özelliklerini ve olaylarını önbellekten temizler.
Refresh(Module)	Belirtilen modülün özelliklerini ve olaylarını önbellekten temizler.
Refresh(Object)	Belirtilen bileşenin özelliklerini ve olaylarını önbellekten temizler.
Refresh(Type)	Belirtilen bileşen türü için özellikleri ve olayları önbellekten temizler.
RegisterType<T>()	Türü, kırpılan uygulamalarda yansıma tabanlı sağlayıcılar tarafından kullanılabilmesi için kaydeder.
RemoveAssociation(Object, Object)	İki nesne arasındaki ilişkiyi kaldırır.
RemoveAssociations(Object)	Birincil nesnenin tüm ilişkilendirmelerini kaldırır.
RemoveProvider(TypeDescriptionProvider, Object)	Belirtilen nesneyle ilişkili daha önce eklenmiş bir tür açıklaması sağlayıcısını kaldırır.
RemoveProvider(TypeDescriptionProvider, Type)	Belirtilen türle ilişkili daha önce eklenmiş bir tür açıklaması sağlayıcısını kaldırır.
RemoveProviderTransparent(TypeDescriptionProvider, Object)	Belirtilen nesneyle ilişkili daha önce eklenmiş bir tür açıklaması sağlayıcısını kaldırır.
RemoveProviderTransparent(TypeDescriptionProvider, Type)	Belirtilen türle ilişkili daha önce eklenmiş bir tür açıklaması sağlayıcısını kaldırır.
SortDescriptorArray(IList)	Tanımlayıcıları tanımlayıcının adını kullanarak sıralar.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ekinlikler

Name	Description
Refreshed	Bir bileşenin önbelleği temizlendiğinde gerçekleşir.

Ayrıca bkz.

• EventDescriptor
• PropertyDescriptor
• System.Reflection
• IComponent
• ISite
• Yansıma