PropertyDescriptorCollection Classe

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Origem:

PropertyDescriptorCollection.cs

Representa uma coleção de objetos 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

Herança

Object

PropertyDescriptorCollection

Implementações

ICollection IDictionary IEnumerable IList

Exemplos

O exemplo de código a seguir cria um novo PropertyDescriptorCollection usando as propriedades em button1. Ele requer que button1 tenha sido instanciado em um formulário.

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

PropertyDescriptorCollection properties = TypeDescriptor.GetProperties(button1);

Dim properties As PropertyDescriptorCollection = TypeDescriptor.GetProperties(button1)

O exemplo a seguir imprime todas as propriedades em um botão em uma caixa de texto. Requer isso button1 e textBox1 ter sido instanciado em um formulário.

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

Comentários

PropertyDescriptorCollection é somente leitura; ele não implementa métodos que adicionam ou removem propriedades. Você deve herdar dessa classe para implementar esses métodos.

Usando as propriedades disponíveis na PropertyDescriptorCollection classe , você pode consultar a coleção sobre seu conteúdo. Use a Count propriedade para determinar o número de elementos na coleção. Use a Item[] propriedade para obter uma propriedade específica por número de índice ou por nome.

Além das propriedades, você pode usar o Find método para obter uma descrição da propriedade com o nome especificado da coleção.

Construtores

PropertyDescriptorCollection(PropertyDescriptor[])	Inicializa uma nova instância da classe PropertyDescriptorCollection.
PropertyDescriptorCollection(PropertyDescriptor[], Boolean)	Inicializa uma nova instância da classe PropertyDescriptorCollection, que pode ser somente leitura.

Campos

Empty

Especifica uma coleção vazia que você pode usar em vez de criar uma nova sem nenhum item. Esse campo static é somente leitura.

Propriedades

Count	Obtém o número de descritores de propriedade na coleção.
Item[Int32]	Obtém ou define o PropertyDescriptor no número de índice especificado.
Item[String]	Obtém ou define o PropertyDescriptor com o nome especificado.

Métodos

Add(PropertyDescriptor)	Adiciona o PropertyDescriptor especificado à coleção.
Clear()	Remove todos os objetos PropertyDescriptor da coleção.
Contains(PropertyDescriptor)	Retorna se a coleção contém o PropertyDescriptor indicado.
CopyTo(Array, Int32)	Copia toda a coleção para uma matriz, começando no número de índice especificado.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Find(String, Boolean)	Retorna o PropertyDescriptor com o nome especificado, usando um booliano para indicar se você deseja ignorar a diferenciação de maiúsculas e minúsculas.
GetEnumerator()	Retorna um enumerador para esta classe.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(PropertyDescriptor)	Retorna o índice do PropertyDescriptor fornecido.
Insert(Int32, PropertyDescriptor)	Adiciona o PropertyDescriptor à coleção no número de índice especificado.
InternalSort(IComparer)	Classifica os membros desta coleção usando o IComparer especificado.
InternalSort(String[])	Classifica os membros desta coleção. A ordem especificada é aplicada primeiro, seguida pela classificação padrão para esta coleção, que é geralmente em ordem alfabética.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Remove(PropertyDescriptor)	Remove o PropertyDescriptor especificado da coleção.
RemoveAt(Int32)	Remove o PropertyDescriptor no índice especificado da coleção.
Sort()	Classifica os membros desta coleção usando a classificação padrão desta coleção, que, geralmente, é em ordem alfabética.
Sort(IComparer)	Classifica os membros desta coleção usando o IComparer especificado.
Sort(String[])	Classifica os membros desta coleção. A ordem especificada é aplicada primeiro, seguida pela classificação padrão para esta coleção, que é geralmente em ordem alfabética.
Sort(String[], IComparer)	Classifica os membros desta coleção. A ordem especificada é aplicada primeiro, seguida pela classificação usando o IComparer especificado.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

ICollection.Count	Obtém o número de elementos contidos na coleção.
ICollection.IsSynchronized	Obtém um valor que indica se o acesso à coleção é sincronizado (thread-safe).
ICollection.SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso à coleção.
IDictionary.Add(Object, Object)	Adiciona um elemento com a chave fornecida e o valor para o IDictionary.
IDictionary.Clear()	Remove todos os elementos do IDictionary.
IDictionary.Contains(Object)	Determina se o IDictionary contém um elemento com a chave especificada.
IDictionary.GetEnumerator()	Retorna um enumerador para esta classe.
IDictionary.IsFixedSize	Obtém um valor que indica se o IDictionary tem um tamanho fixo.
IDictionary.IsReadOnly	Obtém um valor que indica se o IDictionary é somente leitura.
IDictionary.Item[Object]	Obtém ou define o elemento com a chave especificada.
IDictionary.Keys	Obtém um ICollection que contém as chaves do IDictionary.
IDictionary.Remove(Object)	Remove o elemento com a chave especificada do IDictionary.
IDictionary.Values	Obtém um ICollection que contém os valores no IDictionary.
IEnumerable.GetEnumerator()	Retorna um IEnumerator para o IDictionary.
IList.Add(Object)	Adiciona um item ao IList.
IList.Clear()	Remove todos os itens da coleção.
IList.Contains(Object)	Determina se a coleção contém um valor específico.
IList.IndexOf(Object)	Determina o índice de um item especificado na coleção.
IList.Insert(Int32, Object)	Insere um item na coleção em um índice especificado.
IList.IsFixedSize	Obtém um valor que indica se a coleção tem um tamanho fixo.
IList.IsReadOnly	Obtém um valor que indica se a coleção é somente leitura.
IList.Item[Int32]	Obtém ou define um item da coleção em um índice especificado.
IList.Remove(Object)	Remove a primeira ocorrência de um valor especificado da coleção.
IList.RemoveAt(Int32)	Remove o item no índice especificado.

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Confira também

• PropertyDescriptor
• TypeDescriptor