PropertyDescriptorCollection.Item[] Eigenschaft

Definition

Ruft den angegebenen PropertyDescriptor ab oder legt diesen fest.Gets or sets the specified PropertyDescriptor.

Überlädt

Item[Int32]

Ruft den PropertyDescriptor an der angegebenen Indexnummer ab oder legt diesen fest.Gets or sets the PropertyDescriptor at the specified index number.

Item[String]

Ruft den PropertyDescriptor mit dem angegebenen Namen ab oder legt diesen fest.Gets or sets the PropertyDescriptor with the specified name.

Item[Int32]

Ruft den PropertyDescriptor an der angegebenen Indexnummer ab oder legt diesen fest.Gets or sets the PropertyDescriptor at the specified index number.

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

Parameter

index
Int32

Der nullbasierte Index von PropertyDescriptor, der abgerufen oder festgelegt werden soll.The zero-based index of the PropertyDescriptor to get or set.

Eigenschaftswert

PropertyDescriptor

Die PropertyDescriptor-Klasse mit der angegebenen Indexnummer.The PropertyDescriptor with the specified index number.

Ausnahmen

Der index-Parameter ist kein gültiger Index für Item[Int32].The index parameter is not a valid index for Item[Int32].

Beispiele

Im folgenden Codebeispiel wird die- Item[] Eigenschaft verwendet, um den Namen der PropertyDescriptor durch die Indexnummer in einem Textfeld angegebenen zu drucken.The following code example uses the Item[] property to print the name of the PropertyDescriptor specified by the index number in a text box. Da die Indexnummer Null basiert ist, druckt dieses Beispiel den Namen des zweiten PropertyDescriptor .Because the index number is zero-based, this example prints the name of the second PropertyDescriptor. Es erfordert, dass button1 in einem Formular instanziiert wurde.It requires that button1 has been instantiated on a form.

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

Hinweise

Die Indexnummer ist NULL basiert.The index number is zero-based. Daher müssen Sie 1 von der numerischen Position eines bestimmten subtrahieren PropertyDescriptor , um darauf zuzugreifen PropertyDescriptor .Therefore, you must subtract 1 from the numerical position of a particular PropertyDescriptor to access that PropertyDescriptor. Zum Beispiel müssen Sie angeben, um das dritte zu erhalten PropertyDescriptor myColl[2] .For example, to get the third PropertyDescriptor, you need to specify myColl[2].

Weitere Informationen

Gilt für:

Item[String]

Ruft den PropertyDescriptor mit dem angegebenen Namen ab oder legt diesen fest.Gets or sets the PropertyDescriptor with the specified name.

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

Parameter

name
String

Der Name des PropertyDescriptor, das aus der Auflistung abgerufen werden soll.The name of the PropertyDescriptor to get from the collection.

Eigenschaftswert

PropertyDescriptor

Die PropertyDescriptor-Klasse mit dem angegebenen Namen oder null, wenn die Eigenschaft nicht vorhanden ist.The PropertyDescriptor with the specified name, or null if the property does not exist.

Beispiele

Im folgenden Codebeispiel wird die- Item[] Eigenschaft verwendet, um den Typ der Komponente für das PropertyDescriptor vom Index angegebene zu drucken.The following code example uses the Item[] property to print the type of component for the PropertyDescriptor specified by the index. Dies erfordert, dass button1 und textBox1 in einem Formular instanziiert wurden.It requires that button1 and textBox1 have been instantiated on a form.

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

Hinweise

Bei der Item[] Suche nach Namen wird die Groß-/Kleinschreibung beachtet.The Item[] property is case-sensitive when searching for names. Das heißt, dass die Namen "pname" und "pname" als zwei verschiedene Eigenschaften betrachtet werden.That is, the names "Pname" and "pname" are considered to be two different properties.

Weitere Informationen

Gilt für: