PropertyDescriptorCollection Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Source:

PropertyDescriptorCollection.cs

Rappresenta una raccolta di oggetti 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

Ereditarietà

Object

PropertyDescriptorCollection

Implementazioni

ICollection IDictionary IEnumerable IList

Esempio

Nell'esempio di codice seguente viene creato un nuovo PropertyDescriptorCollection uso delle proprietà in button1. Richiede che button1 sia stata creata un'istanza in un modulo.

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

PropertyDescriptorCollection properties = TypeDescriptor.GetProperties(button1);

Dim properties As PropertyDescriptorCollection = TypeDescriptor.GetProperties(button1)

L'esempio successivo stampa tutte le proprietà in un pulsante in una casella di testo. Richiede che button1 sia stata creata un'istanza textBox1 di un modulo.

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

Commenti

PropertyDescriptorCollection è di sola lettura; non implementa metodi che aggiungono o rimuoveno proprietà. È necessario ereditare da questa classe per implementare questi metodi.

Usando le proprietà disponibili nella PropertyDescriptorCollection classe, è possibile eseguire query sulla raccolta sul relativo contenuto. Utilizzare la proprietà Count per determinare il numero di elementi nella raccolta. Utilizzare la Item[] proprietà per ottenere una proprietà specifica in base al numero di indice o al nome.

Oltre alle proprietà, è possibile usare il Find metodo per ottenere una descrizione della proprietà con il nome specificato dalla raccolta.

Costruttori

PropertyDescriptorCollection(PropertyDescriptor[])	Inizializza una nuova istanza della classe PropertyDescriptorCollection.
PropertyDescriptorCollection(PropertyDescriptor[], Boolean)	Inizializza una nuova istanza della classe PropertyDescriptorCollection, che è facoltativamente di sola lettura.

Campi

Empty

Consente di specificare un insieme vuoto che può essere utilizzato invece di crearne uno nuovo senza elementi. Questo campo static è di sola lettura.

Proprietà

Count	Ottiene il numero di descrittori di proprietà nell'insieme.
Item[Int32]	Ottiene o imposta l'oggetto PropertyDescriptor in corrispondenza del numero di indice specificato.
Item[String]	Ottiene o imposta la classe PropertyDescriptor con il nome specificato.

Metodi

Add(PropertyDescriptor)	Aggiunge l'oggetto PropertyDescriptor specificato alla raccolta.
Clear()	Rimuove tutti gli oggetti PropertyDescriptor dalla raccolta.
Contains(PropertyDescriptor)	Indica se l'insieme contiene il dato oggetto PropertyDescriptor.
CopyTo(Array, Int32)	Consente di copiare l'intero insieme in una matrice, iniziando dal numero di indice specificato.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Find(String, Boolean)	Restituisce l'oggetto PropertyDescriptor con il nome specificato, utilizzando un valore Boolean per indicare se ignorare la distinzione fra maiuscole e minuscole.
GetEnumerator()	Restituisce un enumeratore per questa classe.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(PropertyDescriptor)	Restituisce l'indice dell'oggetto PropertyDescriptor specificato.
Insert(Int32, PropertyDescriptor)	Consente di aggiungere all'insieme l'oggetto PropertyDescriptor in corrispondenza del numero di indice specificato.
InternalSort(IComparer)	Consente di ordinare i membri dell'insieme utilizzando l'oggetto IComparer specificato.
InternalSort(String[])	Consente di ordinare i membri dell'insieme. Viene applicato per primo l'ordinamento specificato, seguito dall'ordinamento predefinito di questo insieme, generalmente in ordine alfabetico.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(PropertyDescriptor)	Rimuove l'oggetto PropertyDescriptor specificato dalla raccolta.
RemoveAt(Int32)	Rimuove l'oggetto PropertyDescriptor in corrispondenza dell'indice specificato dall'insieme.
Sort()	Consente di ordinare i membri dell'insieme utilizzando l'ordine predefinito, che è generalmente quello alfabetico.
Sort(IComparer)	Consente di ordinare i membri dell'insieme utilizzando l'oggetto IComparer specificato.
Sort(String[])	Consente di ordinare i membri dell'insieme. Viene applicato per primo l'ordinamento specificato, seguito dall'ordinamento predefinito di questo insieme, generalmente in ordine alfabetico.
Sort(String[], IComparer)	Consente di ordinare i membri dell'insieme. Viene applicato per primo l'ordinamento specificato, seguito dall'ordinamento che utilizza l'oggetto IComparer specificato.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

ICollection.Count	Ottiene il numero di elementi contenuti nella raccolta.
ICollection.IsSynchronized	Ottiene un valore che indica se l'accesso alla raccolta è sincronizzato (thread-safe).
ICollection.SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso alla raccolta.
IDictionary.Add(Object, Object)	Aggiunge un elemento con la chiave e il valore forniti all'interfaccia IDictionary.
IDictionary.Clear()	Rimuove tutti gli elementi da IDictionary.
IDictionary.Contains(Object)	Determina se IDictionary contiene un elemento con la chiave specificata.
IDictionary.GetEnumerator()	Restituisce un enumeratore per questa classe.
IDictionary.IsFixedSize	Ottiene un valore che indica se IDictionary ha dimensioni fisse.
IDictionary.IsReadOnly	Ottiene un valore che indica se IDictionary è di sola lettura.
IDictionary.Item[Object]	Ottiene o imposta l'elemento con la chiave specificata.
IDictionary.Keys	Ottiene ICollection contenente le chiavi di IDictionary.
IDictionary.Remove(Object)	Rimuove l'elemento con la chiave specificata da IDictionary.
IDictionary.Values	Ottiene ICollection contenente i valori in IDictionary.
IEnumerable.GetEnumerator()	Restituisce IEnumerator per IDictionary.
IList.Add(Object)	Aggiunge un elemento a IList.
IList.Clear()	Rimuove tutti gli elementi dalla raccolta.
IList.Contains(Object)	Determina se la raccolta contiene un valore specifico.
IList.IndexOf(Object)	Determina l'indice di un elemento specifico dell'insieme.
IList.Insert(Int32, Object)	Inserisce un elemento nella raccolta in corrispondenza di un indice specificato.
IList.IsFixedSize	Ottiene un valore che indica se la dimensione della raccolta è fissa.
IList.IsReadOnly	Ottiene un valore che indica se la raccolta è di sola lettura.
IList.Item[Int32]	Ottiene o imposta un elemento dall'insieme in corrispondenza dell'indice specificato.
IList.Remove(Object)	Rimuove dall'insieme la prima occorrenza del valore specificato.
IList.RemoveAt(Int32)	Rimuove l'elemento all'indice specificato.

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.

Vedi anche

• PropertyDescriptor
• TypeDescriptor