TypeDescriptor Sınıf

Tanım

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
TypeDescriptor

Açıklamalar

.NET Framework, bir türdeki meta verilere erişmek için iki yol sağlar: ad alanında sağlanan yansıma API'si System.ReflectionTypeDescriptor ve sınıfı. Yansıma, temeli kök Object sınıfın yönteminde GetType oluşturulduğundan 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ştirilememesi açısından 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ımanın aksine, 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 Bir bileşen tarafından kullanıma sunulan standart meta verileri değiştirmek için başka bir nesne etkinleştirir.
ICustomTypeDescriptor Bir sınıfın kendi meta verilerini tamamen ve dinamik olarak belirtmesini sağlar ve standart denetim mekanizmasını TypeDescriptordeğiştirir.

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şeni çağıran yöntemini kullanın. Sınıf türü için çağıran yöntemini yalnızca nesnesinin 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 sabittirler. 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önteminin çağrılması gerekir.

Özellikler

ComNativeDescriptorHandler
Geçersiz.
Geçersiz.
Geçersiz.
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

AddAttributes(Object, Attribute[])

Hedef bileşen örneğine sınıf düzeyinde öznitelikler ekler.

AddAttributes(Type, Attribute[])

Hedef bileşen türüne sınıf düzeyi öznitelikler ekler.

AddEditorTable(Type, Hashtable)

Verilen düzenleyici temel türü için bir düzenleyici tablosu ekler.

AddProvider(TypeDescriptionProvider, Object)

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)

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ştirebilecek bir nesne oluşturur.

CreateProperty(Type, PropertyDescriptor, Attribute[])

Belirtilen mevcut PropertyDescriptor ve öznitelik dizisini kullanarak mevcut 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)

Belirtilen bileşen için öznitelik koleksiyonunu 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(Type)

Belirtilen bileşen türü için bir öznitelik koleksiyonu 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(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(Type)

Belirtilen tür için sınıfın 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.

GetComponentName(Object, Boolean)

Özel bir tür tanımlayıcısı kullanarak belirtilen bileşenin adını döndürür.

GetConverter(Object)

Belirtilen bileşenin türü için bir tür dönüştürücü 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(Type)

Belirtilen tür için bir tür dönüştürücüsü döndürür.

GetDefaultEvent(Object)

Belirtilen bileşen için varsayılan olayı döndürü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(Type)

Belirtilen bileşen türü için varsayılan olayı döndürür.

GetDefaultProperty(Object)

Belirtilen bileşen için varsayılan özelliği 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(Type)

Belirtilen bileşen türü için varsayılan özelliği döndürür.

GetEditor(Object, Type)

Belirtilen bileşen için belirtilen temel türe sahip bir düzenleyici alır.

GetEditor(Object, Type, Boolean)

Belirtilen temel türe sahip ve belirtilen bileşen için özel tür tanımlayıcısı olan bir düzenleyici döndürür.

GetEditor(Type, Type)

Belirtilen tür için belirtilen temel türe sahip bir düzenleyici döndürür.

GetEvents(Object)

Belirtilen bileşen için olay koleksiyonunu döndürür.

GetEvents(Object, Attribute[])

Filtre olarak belirtilen öznitelik dizisini kullanarak belirtilen bileşen için olay koleksiyonunu döndürür.

GetEvents(Object, Attribute[], Boolean)

Filtre olarak belirtilen öznitelik dizisini ve özel tür tanımlayıcısını 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 bileşen için olay koleksiyonunu döndürür.

GetEvents(Type)

Belirtilen bileşen türü için olay koleksiyonunu döndürür.

GetEvents(Type, Attribute[])

Filtre olarak belirtilen öznitelik dizisini kullanarak belirtilen bileşen türü için olay koleksiyonunu döndürü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)

Belirtilen bileşen için özellik koleksiyonunu döndürür.

GetProperties(Object, Attribute[])

Filtre olarak belirtilen öznitelik dizisini kullanarak belirtilen bir bileşen için özellik koleksiyonunu döndürür.

GetProperties(Object, Attribute[], Boolean)

Filtre olarak belirtilen öznitelik dizisini ve özel tür tanımlayıcısını 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 bileşen için özellik koleksiyonunu döndürür.

GetProperties(Type)

Belirtilen bileşen türü için özellik koleksiyonunu döndürür.

GetProperties(Type, Attribute[])

Filtre olarak belirtilen öznitelik dizisini kullanarak belirtilen bileşen türü için özellik koleksiyonunu döndürü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 Sınıf türüne göre yansıma gerçekleştirmek için kullanılabilecek bir döndürür.

GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ 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ünün özelliklerini ve olaylarını önbellekten temizler.

RemoveAssociation(Object, Object)

İki nesne arasındaki ilişkiyi kaldırır.

RemoveAssociations(Object)

Birincil nesne için tüm ilişkilendirmeleri kaldırır.

RemoveProvider(TypeDescriptionProvider, Object)

Belirtilen nesneyle ilişkilendirilmiş daha önce eklenmiş bir tür açıklaması sağlayıcısını kaldırır.

RemoveProvider(TypeDescriptionProvider, Type)

Belirtilen türle ilişkilendirilmiş önceden eklenmiş bir tür açıklaması sağlayıcısını kaldırır.

RemoveProviderTransparent(TypeDescriptionProvider, Object)

Belirtilen nesneyle ilişkilendirilmiş daha önce eklenmiş bir tür açıklaması sağlayıcısını kaldırır.

RemoveProviderTransparent(TypeDescriptionProvider, Type)

Belirtilen türle ilişkilendirilmiş önceden 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 dizeyi döndürür.

(Devralındığı yer: Object)

Ekinlikler

Refreshed

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

Şunlara uygulanır

Ayrıca bkz.