TypeDescriptor Kelas

Definisi

Ruang nama:

System.ComponentModel

Rakitan:

System.ComponentModel.TypeConverter.dll

Sumber:

TypeDescriptor.cs

Menyediakan informasi tentang karakteristik untuk komponen, seperti atribut, properti, dan peristiwanya. Kelas ini tidak dapat diwariskan.

public ref class TypeDescriptor sealed

public sealed class TypeDescriptor

type TypeDescriptor = class

Public NotInheritable Class TypeDescriptor

Warisan

Object

TypeDescriptor

Keterangan

.NET Framework menyediakan dua cara untuk mengakses metadata pada jenis: API refleksi yang disediakan di namespace System.Reflection, dan kelas TypeDescriptor. Refleksi adalah mekanisme umum yang tersedia untuk semua jenis karena fondasinya didirikan dalam metode GetType kelas Object akar. Informasi yang dikembalikannya untuk jenis tidak dapat diperluas, karena tidak dapat dimodifikasi setelah kompilasi jenis target. Untuk informasi selengkapnya, lihat topik di Reflection.

Sebaliknya, TypeDescriptor adalah mekanisme pemeriksaan yang dapat diperluas untuk komponen: kelas yang mengimplementasikan antarmuka IComponent. Tidak seperti refleksi, itu tidak memeriksa metode. TypeDescriptor dapat diperluas secara dinamis oleh beberapa layanan yang tersedia melalui Sitekomponen target . Tabel berikut ini memperlihatkan layanan ini.

Nama layanan	Deskripsi
IExtenderProvider	Memungkinkan kelas lain, seperti ToolTip, untuk menyediakan properti tambahan ke komponen.
ITypeDescriptorFilterService	Memungkinkan objek lain untuk mengubah metadata standar yang diekspos oleh komponen.
ICustomTypeDescriptor	Memungkinkan kelas untuk menentukan metadatanya sendiri sepenuhnya dan dinamis, menggantikan mekanisme pemeriksaan standar TypeDescriptor.

Ekstensibilitas yang disediakan oleh TypeDescriptor memungkinkan representasi waktu desain komponen berbeda dari representasi run-time aktualnya, yang membuat TypeDescriptor berguna untuk membangun infrastruktur waktu desain.

Semua metode dalam TypeDescriptorstatic. Anda tidak dapat membuat instans kelas ini, dan kelas ini tidak dapat diwariskan.

Anda dapat mengatur nilai properti dan peristiwa dengan dua cara berbeda: tentukan di kelas komponen atau ubah pada waktu desain. Karena Anda dapat mengatur nilai-nilai ini dua cara, metode TypeDescriptor yang kelebihan beban mengambil dua jenis parameter yang berbeda: jenis kelas atau instans objek.

Saat Anda ingin mengakses informasi TypeDescriptor dan Anda memiliki instans objek, gunakan metode yang memanggil komponen. Gunakan metode yang memanggil jenis kelas hanya ketika Anda tidak memiliki instans objek.

Properti dan peristiwa di-cache oleh TypeDescriptor untuk kecepatan. Biasanya, konstan untuk masa pakai objek. Namun, penyedia dan desainer extender dapat mengubah kumpulan properti pada objek. Jika demikian, maka metode Refresh harus dipanggil untuk memperbarui cache.

Properti

ComNativeDescriptorHandler	Kedaluwarsa. Mendapatkan atau mengatur penyedia untuk informasi jenis Model Objek Komponen (COM) untuk komponen target.
ComObjectType	Mendapatkan jenis objek Model Objek Komponen (COM) yang diwakili oleh komponen target.
InterfaceType	Mendapatkan jenis yang mewakili penyedia deskripsi jenis untuk semua jenis antarmuka.

Metode

AddAttributes(Object, Attribute[])	Menambahkan atribut tingkat kelas ke instans komponen target.
AddAttributes(Type, Attribute[])	Menambahkan atribut tingkat kelas ke jenis komponen target.
AddEditorTable(Type, Hashtable)	Menambahkan tabel editor untuk jenis dasar editor yang diberikan.
AddProvider(TypeDescriptionProvider, Object)	Menambahkan penyedia deskripsi jenis untuk satu instans komponen.
AddProvider(TypeDescriptionProvider, Type)	Menambahkan penyedia deskripsi jenis untuk kelas komponen.
AddProviderTransparent(TypeDescriptionProvider, Object)	Menambahkan penyedia deskripsi jenis untuk satu instans komponen.
AddProviderTransparent(TypeDescriptionProvider, Type)	Menambahkan penyedia deskripsi jenis untuk kelas komponen.
CreateAssociation(Object, Object)	Membuat asosiasi sekunder utama antara dua objek.
CreateDesigner(IComponent, Type)	Membuat instans perancang yang terkait dengan komponen yang ditentukan dan dari jenis perancang yang ditentukan.
CreateEvent(Type, EventDescriptor, Attribute[])	Membuat pendeskripsi peristiwa baru yang identik dengan deskriptor peristiwa yang ada, saat melewati EventDescriptoryang ada.
CreateEvent(Type, String, Type, Attribute[])	Membuat deskriptor peristiwa baru yang identik dengan deskriptor peristiwa yang ada dengan menghasilkan informasi deskriptor secara dinamis dari peristiwa tertentu pada jenis.
CreateInstance(IServiceProvider, Type, Type[], Object[])	Membuat objek yang dapat menggantikan jenis data lain.
CreateProperty(Type, PropertyDescriptor, Attribute[])	Membuat deskriptor properti baru dari deskriptor properti yang ada, menggunakan array PropertyDescriptor dan atribut yang ada yang ditentukan.
CreateProperty(Type, String, Type, Attribute[])	Membuat dan secara dinamis mengikat deskriptor properti ke jenis, menggunakan nama properti, jenis, dan array atribut yang ditentukan.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetAssociation(Type, Object)	Mengembalikan instans jenis yang terkait dengan objek utama yang ditentukan.
GetAttributes(Object)	Mengembalikan kumpulan atribut untuk komponen yang ditentukan.
GetAttributes(Object, Boolean)	Mengembalikan kumpulan atribut untuk komponen yang ditentukan dan Boolean yang menunjukkan bahwa deskriptor jenis kustom telah dibuat.
GetAttributes(Type)	Mengembalikan kumpulan atribut untuk jenis komponen yang ditentukan.
GetClassName(Object)	Mengembalikan nama kelas untuk komponen yang ditentukan menggunakan deskriptor jenis default.
GetClassName(Object, Boolean)	Mengembalikan nama kelas untuk komponen yang ditentukan menggunakan deskriptor jenis kustom.
GetClassName(Type)	Mengembalikan nama kelas untuk jenis yang ditentukan.
GetComponentName(Object)	Mengembalikan nama komponen yang ditentukan menggunakan deskriptor jenis default.
GetComponentName(Object, Boolean)	Mengembalikan nama komponen yang ditentukan menggunakan deskriptor jenis kustom.
GetConverter(Object)	Mengembalikan pengonversi jenis untuk jenis komponen yang ditentukan.
GetConverter(Object, Boolean)	Mengembalikan pengonversi jenis untuk jenis komponen yang ditentukan dengan deskriptor jenis kustom.
GetConverter(Type)	Mengembalikan pengonversi jenis untuk jenis yang ditentukan.
GetDefaultEvent(Object)	Mengembalikan peristiwa default untuk komponen yang ditentukan.
GetDefaultEvent(Object, Boolean)	Mengembalikan peristiwa default untuk komponen dengan deskriptor jenis kustom.
GetDefaultEvent(Type)	Mengembalikan peristiwa default untuk jenis komponen yang ditentukan.
GetDefaultProperty(Object)	Mengembalikan properti default untuk komponen yang ditentukan.
GetDefaultProperty(Object, Boolean)	Mengembalikan properti default untuk komponen yang ditentukan dengan deskriptor jenis kustom.
GetDefaultProperty(Type)	Mengembalikan properti default untuk jenis komponen yang ditentukan.
GetEditor(Object, Type)	Mendapatkan editor dengan jenis dasar yang ditentukan untuk komponen yang ditentukan.
GetEditor(Object, Type, Boolean)	Mengembalikan editor dengan jenis dasar yang ditentukan dan dengan deskriptor jenis kustom untuk komponen yang ditentukan.
GetEditor(Type, Type)	Mengembalikan editor dengan jenis dasar yang ditentukan untuk jenis yang ditentukan.
GetEvents(Object)	Mengembalikan kumpulan peristiwa untuk komponen yang ditentukan.
GetEvents(Object, Attribute[])	Mengembalikan kumpulan peristiwa untuk komponen tertentu menggunakan array atribut tertentu sebagai filter.
GetEvents(Object, Attribute[], Boolean)	Mengembalikan kumpulan peristiwa untuk komponen tertentu menggunakan array atribut tertentu sebagai filter dan menggunakan deskriptor jenis kustom.
GetEvents(Object, Boolean)	Mengembalikan kumpulan peristiwa untuk komponen tertentu dengan deskriptor jenis kustom.
GetEvents(Type)	Mengembalikan kumpulan peristiwa untuk jenis komponen tertentu.
GetEvents(Type, Attribute[])	Mengembalikan kumpulan peristiwa untuk jenis komponen tertentu menggunakan array atribut tertentu sebagai filter.
GetFullComponentName(Object)	Mengembalikan nama komponen yang sepenuhnya memenuhi syarat.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetProperties(Object)	Mengembalikan kumpulan properti untuk komponen tertentu.
GetProperties(Object, Attribute[])	Mengembalikan kumpulan properti untuk komponen tertentu menggunakan array atribut tertentu sebagai filter.
GetProperties(Object, Attribute[], Boolean)	Mengembalikan kumpulan properti untuk komponen tertentu menggunakan array atribut tertentu sebagai filter dan menggunakan deskriptor jenis kustom.
GetProperties(Object, Boolean)	Mengembalikan kumpulan properti untuk komponen tertentu menggunakan deskriptor jenis default.
GetProperties(Type)	Mengembalikan kumpulan properti untuk jenis komponen tertentu.
GetProperties(Type, Attribute[])	Mengembalikan kumpulan properti untuk jenis komponen tertentu menggunakan array atribut tertentu sebagai filter.
GetProvider(Object)	Mengembalikan penyedia deskripsi jenis untuk komponen yang ditentukan.
GetProvider(Type)	Mengembalikan penyedia deskripsi jenis untuk jenis yang ditentukan.
GetReflectionType(Object)	Mengembalikan Type yang dapat digunakan untuk melakukan pantulan, diberikan objek.
GetReflectionType(Type)	Mengembalikan Type yang dapat digunakan untuk melakukan pantulan, dengan jenis kelas.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
Refresh(Assembly)	Menghapus properti dan peristiwa untuk rakitan yang ditentukan dari cache.
Refresh(Module)	Menghapus properti dan peristiwa untuk modul yang ditentukan dari cache.
Refresh(Object)	Menghapus properti dan peristiwa untuk komponen yang ditentukan dari cache.
Refresh(Type)	Menghapus properti dan peristiwa untuk jenis komponen yang ditentukan dari cache.
RemoveAssociation(Object, Object)	Menghapus hubungan antara dua objek.
RemoveAssociations(Object)	Menghapus semua asosiasi untuk objek utama.
RemoveProvider(TypeDescriptionProvider, Object)	Menghapus penyedia deskripsi tipe yang ditambahkan sebelumnya yang terkait dengan objek yang ditentukan.
RemoveProvider(TypeDescriptionProvider, Type)	Menghapus penyedia deskripsi tipe yang ditambahkan sebelumnya yang terkait dengan jenis yang ditentukan.
RemoveProviderTransparent(TypeDescriptionProvider, Object)	Menghapus penyedia deskripsi tipe yang ditambahkan sebelumnya yang terkait dengan objek yang ditentukan.
RemoveProviderTransparent(TypeDescriptionProvider, Type)	Menghapus penyedia deskripsi tipe yang ditambahkan sebelumnya yang terkait dengan jenis yang ditentukan.
SortDescriptorArray(IList)	Mengurutkan deskriptor menggunakan nama deskriptor.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Acara

Refreshed

Terjadi ketika cache untuk komponen dibersihkan.

Lihat juga

• EventDescriptor
• PropertyDescriptor
• System.Reflection
• IComponent
• ISite
• Gambaran Umum Deskriptor Tipe
• Refleksi