TypeDescriptor Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bir bileşenin öznitelikleri, özellikleri ve olayları gibi özellikleri hakkında bilgi sağlar. Bu sınıf devralınamaz.
public ref class TypeDescriptor sealedpublic sealed class TypeDescriptortype TypeDescriptor = classPublic NotInheritable Class TypeDescriptor- Devralma
-
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ın GetType yönteminde oluşturulduğundan yansıma, tüm türlerin kullanımına sunulan 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ımakonusuna bakın.
Buna karşılık, TypeDescriptor bileşenler için genişletilebilir bir denetim mekanizmasıdır: IComponent arabirimini uygulayan 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 ToolTipgibi baş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 TypeDescriptorstandart denetim mekanizmasını değiştirir. |
TypeDescriptor tarafından 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 TypeDescriptor tasarım zamanı altyapısı oluşturmak için yararlı olmasını sağlar.
TypeDescriptor içindeki tüm yöntemler 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, TypeDescriptor aşırı yüklenmiş yöntemleri iki farklı parametre türü alır: sınıf türü veya nesne örneği.
TypeDescriptor bilgilere erişmek istediğinizde ve nesnenin 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 nesnenin bir örneğine sahip olmadığınızda kullanın.
Özellikler ve olaylar hız için TypeDescriptor tarafından önbelleğe alınır. 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. Böyle bir durumda önbelleği güncelleştirmek için Refresh yöntemi çağrılmalıdır.
Ö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ü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 EventDescriptorgeçirildiğinde, mevcut olay tanımlayıcısı ile aynı olan yeni bir olay tanımlayıcısı oluş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 mevcut PropertyDescriptor 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) |
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üsü 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ü 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) |
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 ve belirtilen bileşen için özel tür tanımlayıcıya sahip 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[]) |
Belirtilen öznitelik dizisini filtre olarak kullanarak belirtilen bir bileşen için olay koleksiyonunu 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, Boolean) |
Özel tür tanımlayıcısı ile belirtilen bir 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[]) |
Belirtilen öznitelik dizisini filtre olarak kullanarak 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) |
Belirtilen 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, 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, Boolean) |
Varsayılan tür tanımlayıcısını kullanarak belirtilen bir bileşenin özellik koleksiyonunu döndürür. |
| GetProperties(Type) |
Belirtilen bileşen türü 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. |
| 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 verilip yansıma gerçekleştirmek için kullanılabilecek bir Type döndürür. |
| GetReflectionType(Type) |
Sınıf türüne göre yansıma gerçekleştirmek için kullanılabilecek bir Type 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
| Refreshed |
Bir bileşenin önbelleği temizlendiğinde gerçekleşir. |
