PropertyDescriptorCollection 类

定义

命名空间:

System.ComponentModel

程序集:

System.ComponentModel.TypeConverter.dll

Source:

PropertyDescriptorCollection.cs

表示 PropertyDescriptor 对象集合。

public ref class PropertyDescriptorCollection : System::Collections::IDictionary, System::Collections::IList

public class PropertyDescriptorCollection : System.Collections.IDictionary, System.Collections.IList

type PropertyDescriptorCollection = class
    interface ICollection
    interface IEnumerable
    interface IDictionary
    interface IList

Public Class PropertyDescriptorCollection
Implements IDictionary, IList

继承

Object

PropertyDescriptorCollection

实现

ICollection IDictionary IEnumerable IList

示例

下面的代码示例使用 上的 button1属性创建新的 PropertyDescriptorCollection 。 它要求 button1 已在窗体上实例化。

PropertyDescriptorCollection^ properties = TypeDescriptor::GetProperties( button1 );

PropertyDescriptorCollection properties = TypeDescriptor.GetProperties(button1);

Dim properties As PropertyDescriptorCollection = TypeDescriptor.GetProperties(button1)

下一个示例在文本框中打印按钮上的所有属性。 它要求 button1 和 textBox1 已在窗体上实例化。

private:
   void MyPropertyCollection()
   {
      // Creates a new collection and assign it the properties for button1.
      PropertyDescriptorCollection^ properties = TypeDescriptor::GetProperties( button1 );
      
      // Displays each property in the collection in a text box.
      for each ( PropertyDescriptor^ myProperty in properties )
      {
         textBox1->Text = String::Concat( textBox1->Text, myProperty->Name, "\n" );
      }
   }

private void MyPropertyCollection() {
    // Creates a new collection and assign it the properties for button1.
    PropertyDescriptorCollection properties = TypeDescriptor.GetProperties(button1);
 
    // Displays each property in the collection in a text box.
    foreach (PropertyDescriptor myProperty in properties)
       textBox1.Text += myProperty.Name + '\n';
 }

Private Sub MyPropertyCollection()
    ' Creates a new collection and assign it the properties for button1.
    Dim properties As PropertyDescriptorCollection = TypeDescriptor.GetProperties(button1)
    
    ' Displays each property in the collection in a text box.
    Dim myProperty As PropertyDescriptor
    For Each myProperty In  properties
        textBox1.Text &= myProperty.Name & ControlChars.Cr
    Next myProperty
End Sub

注解

PropertyDescriptorCollection 为只读;它不实现添加或删除属性的方法。 必须从此类继承才能实现这些方法。

使用 类中 PropertyDescriptorCollection 可用的属性，可以查询集合中的内容。 使用 Count 属性可确定集合中的元素数。 Item[]使用 属性可按索引号或名称获取特定属性。

除了属性，还可以使用 Find 方法从集合中获取具有指定名称的属性的说明。

构造函数

PropertyDescriptorCollection(PropertyDescriptor[])	初始化 PropertyDescriptorCollection 类的新实例。
PropertyDescriptorCollection(PropertyDescriptor[], Boolean)	初始化 PropertyDescriptorCollection 类的新实例，该类可以是只读类。

字段

Empty

指定一个可以使用的空集合，而不是创建一个不带任何项的新集合。 此 static 字段是只读的。

属性

Count	获取集合中属性说明符的数目。
Item[Int32]	获取或设置指定索引处的 PropertyDescriptor。
Item[String]	获取或设置具有指定名称的 PropertyDescriptor。

方法

Add(PropertyDescriptor)	将指定的 PropertyDescriptor 添加到集合。
Clear()	从集合中删除所有 PropertyDescriptor 对象。
Contains(PropertyDescriptor)	返回集合是否包含给定的 PropertyDescriptor。
CopyTo(Array, Int32)	从指定的索引号开始，将整个集合复制到数组。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
Find(String, Boolean)	返回具有指定名称的 PropertyDescriptor，使用布尔值指示是否忽略大小写。
GetEnumerator()	返回该类的枚举数。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
IndexOf(PropertyDescriptor)	返回给定 PropertyDescriptor 的索引。
Insert(Int32, PropertyDescriptor)	将 PropertyDescriptor 添加到集合中指定的索引号位置。
InternalSort(IComparer)	使用指定的 IComparer 对此集合中的成员排序。
InternalSort(String[])	对此集合中的成员排序。 首先应用指定的顺序，然后应用此集合的默认排序，后者通常为字母顺序。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Remove(PropertyDescriptor)	从集合中移除指定的 PropertyDescriptor。
RemoveAt(Int32)	从集合中移除指定索引位置的 PropertyDescriptor。
Sort()	使用该集合的默认排序（通常为字母顺序）对集合中的成员进行排序。
Sort(IComparer)	使用指定的 IComparer 对此集合中的成员排序。
Sort(String[])	对此集合中的成员排序。 首先应用指定的顺序，然后应用此集合的默认排序，后者通常为字母顺序。
Sort(String[], IComparer)	对此集合中的成员排序。 首先应用指定的顺序，然后使用指定的 IComparer 进行排序。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

ICollection.Count	获取集合中包含的元素数。
ICollection.IsSynchronized	获取一个值，该值指示对集合的访问是否为同步的（线程安全）。
ICollection.SyncRoot	获取可用于同步对集合的访问的对象。
IDictionary.Add(Object, Object)	向 IDictionary 添加一个带有所提供的键和值的元素。
IDictionary.Clear()	从 IDictionary 中移除所有元素。
IDictionary.Contains(Object)	确定是否 IDictionary 包含带有指定键的元素。
IDictionary.GetEnumerator()	返回该类的枚举数。
IDictionary.IsFixedSize	获取一个值，该值指示 IDictionary 是否具有固定大小。
IDictionary.IsReadOnly	获取一个值，该值指示 IDictionary 是否为只读。
IDictionary.Item[Object]	获取或设置具有指定键的元素。
IDictionary.Keys	获取包含 ICollection 的键的 IDictionary。
IDictionary.Remove(Object)	从 IDictionary 中移除带有指定键的元素。
IDictionary.Values	获取一个 ICollection，它包含 IDictionary 中的值。
IEnumerable.GetEnumerator()	返回 IEnumerator 的 IDictionary。
IList.Add(Object)	将某项添加到 IList 中。
IList.Clear()	从集合中移除所有项。
IList.Contains(Object)	确定集合中是否包含特定值。
IList.IndexOf(Object)	确定集合中指定项的索引。
IList.Insert(Int32, Object)	将某个项插入到集合中的指定索引处。
IList.IsFixedSize	获取一个值，该值指示集合是否具有固定大小。
IList.IsReadOnly	获取一个值，该值指示集合是否为只读。
IList.Item[Int32]	获取或设置指定索引处的集合中的项。
IList.Remove(Object)	从集合中移除指定的值的第一个匹配项。
IList.RemoveAt(Int32)	删除指定索引处的项。

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

另请参阅

• PropertyDescriptor
• TypeDescriptor