PropertyDescriptorCollection.Item[] Propriedade

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Obtém ou define o PropertyDescriptor especificado.

Sobrecargas

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.

Item[Int32]

Origem:

PropertyDescriptorCollection.cs

Obtém ou define o PropertyDescriptor no número de índice especificado.

public:
 virtual property System::ComponentModel::PropertyDescriptor ^ default[int] { System::ComponentModel::PropertyDescriptor ^ get(int index); };

public virtual System.ComponentModel.PropertyDescriptor this[int index] { get; }

member this.Item(int) : System.ComponentModel.PropertyDescriptor

Default Public Overridable ReadOnly Property Item(index As Integer) As PropertyDescriptor

Parâmetros

index

Int32

O índice de base zero do PropertyDescriptor a ser obtido ou definido.

Valor da propriedade

PropertyDescriptor

O PropertyDescriptor com o número de índice especificado.

Exceções

IndexOutOfRangeException

O parâmetro index não é um índice válido para Item[Int32].

Exemplos

O exemplo de código a seguir usa a Item[] propriedade para imprimir o nome do PropertyDescriptor especificado pelo número de índice em uma caixa de texto. Como o número de índice é baseado em zero, este exemplo imprime o nome do segundo PropertyDescriptor. Ele requer que button1 tenha sido instanciado em um formulário.

void PrintIndexItem()
{
   
   // Creates a new collection and assigns it the properties for button1.
   PropertyDescriptorCollection^ properties = TypeDescriptor::GetProperties( button1 );
   
   // Prints the second property's name.
   textBox1->Text = properties[ 1 ]->ToString();
}

private void PrintIndexItem() {
    // Creates a new collection and assigns it the properties for button1.
    PropertyDescriptorCollection properties = TypeDescriptor.GetProperties(button1);
 
    // Prints the second property's name.
    textBox1.Text = properties[1].ToString();
 }

Private Sub PrintIndexItem()
    ' Creates a new collection and assigns it the properties for button1.
    Dim properties As PropertyDescriptorCollection = TypeDescriptor.GetProperties(button1)
       
    ' Prints the second property's name.
    textBox1.Text = properties(1).ToString()
End Sub

Comentários

O número de índice é baseado em zero. Portanto, você deve subtrair 1 da posição numérica de um específico PropertyDescriptor para acessar esse PropertyDescriptor. Por exemplo, para obter o terceiro PropertyDescriptor, você precisa especificar myColl[2].

Confira também

• PropertyDescriptor
• TypeDescriptor

Item[String]

Origem:

PropertyDescriptorCollection.cs

Obtém ou define o PropertyDescriptor com o nome especificado.

public:
 virtual property System::ComponentModel::PropertyDescriptor ^ default[System::String ^] { System::ComponentModel::PropertyDescriptor ^ get(System::String ^ name); };

public virtual System.ComponentModel.PropertyDescriptor? this[string name] { get; }

member this.Item(string) : System.ComponentModel.PropertyDescriptor

Default Public Overridable ReadOnly Property Item(name As String) As PropertyDescriptor

Parâmetros

name

String

O nome do PropertyDescriptor a ser obtido da coleção.

Valor da propriedade

PropertyDescriptor

O PropertyDescriptor com o nome especificado ou null se a propriedade não existir.

Exemplos

O exemplo de código a seguir usa a Item[] propriedade para imprimir o tipo de componente para o PropertyDescriptor especificado pelo índice. Requer que button1 e textBox1 tenham sido instanciados em um formulário.

void PrintIndexItem2()
{
   
   // Creates a new collection and assigns it the properties for button1.
   PropertyDescriptorCollection^ properties = TypeDescriptor::GetProperties( button1 );
   
   // Sets a PropertyDescriptor to the specific property.
   PropertyDescriptor^ myProperty = properties[ "Opacity" ];
   
   // Prints the display name for the property.
   textBox1->Text = myProperty->DisplayName;
}

private void PrintIndexItem2() {
   // Creates a new collection and assigns it the properties for button1.
   PropertyDescriptorCollection properties =
       TypeDescriptor.GetProperties(button1);

   // Sets a PropertyDescriptor to the specific property.
   PropertyDescriptor myProperty = properties["Opacity"];

   // Prints the display name for the property.
   textBox1.Text = myProperty.DisplayName;
}

Private Sub PrintIndexItem2()
    ' Creates a new collection and assigns it the properties for button1.
    Dim properties As PropertyDescriptorCollection = _
       TypeDescriptor.GetProperties(button1)
       
    ' Sets a PropertyDescriptor to the specific property.
    Dim myProperty As PropertyDescriptor = properties("Opacity")
       
    ' Prints the display name for the property.
    textBox1.Text = myProperty.DisplayName
End Sub

Comentários

A Item[] propriedade diferencia maiúsculas de minúsculas ao pesquisar nomes. Ou seja, os nomes "Pname" e "pname" são considerados duas propriedades diferentes.

Confira também

• PropertyDescriptor
• TypeDescriptor