PropertyDescriptorCollection.Item[String] Свойство

Определение

Получает или задает указанный объект PropertyDescriptor.Gets or sets the specified PropertyDescriptor.

Перегрузки

Item[Int32]

Получает или задает дескриптор PropertyDescriptor с заданным индексом.Gets or sets the PropertyDescriptor at the specified index number.

Item[String]

Возвращает или задает объект PropertyDescriptor с заданным именем.Gets or sets the PropertyDescriptor with the specified name.

Item[Int32]

Получает или задает дескриптор PropertyDescriptor с заданным индексом.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

Параметры

index
Int32

Индекс (с нуля) возвращаемого или задаваемого PropertyDescriptor.The zero-based index of the PropertyDescriptor to get or set.

Значение свойства

Объект PropertyDescriptor с заданным индексом.The PropertyDescriptor with the specified index number.

Исключения

Параметр index является недопустимым индексом Item[Int32] .The index parameter is not a valid index for Item[Int32].

Примеры

В следующем примере кода Item[String] свойство используется для печати имени объекта, PropertyDescriptor указанного с помощью номера индекса в текстовом поле.The following code example uses the Item[String] property to print the name of the PropertyDescriptor specified by the index number in a text box. Поскольку номер индекса основан на отсчете от нуля, в этом примере выводится PropertyDescriptorимя второй.Because the index number is zero-based, this example prints the name of the second PropertyDescriptor. Для этого требуется button1 , чтобы экземпляр был создан в форме.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

Комментарии

Номер индекса отсчитывается от нуля.The index number is zero-based. Поэтому необходимо вычесть 1 из числового расположения конкретного PropertyDescriptor объекта, PropertyDescriptorчтобы получить доступ к нему.Therefore, you must subtract 1 from the numerical position of a particular PropertyDescriptor to access that PropertyDescriptor. Например, чтобы получить третий PropertyDescriptorобъект, необходимо указать. myColl[2]For example, to get the third PropertyDescriptor, you need to specify myColl[2].

Дополнительно

Item[String]

Возвращает или задает объект PropertyDescriptor с заданным именем.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

Параметры

name
String

Имя дескриптора PropertyDescriptor, который нужно получить из коллекции.The name of the PropertyDescriptor to get from the collection.

Значение свойства

Дескриптор PropertyDescriptor с заданным именем или null, если свойство не существует.The PropertyDescriptor with the specified name, or null if the property does not exist.

Примеры

В следующем примере кода Item[String] свойство используется для печати типа компонента для объекта, PropertyDescriptor указанного в индексе.The following code example uses the Item[String] property to print the type of component for the PropertyDescriptor specified by the index. Для этого требуется button1 , textBox1 чтобы экземпляр и был создан в форме.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

Комментарии

При Item[String] поиске имен в свойстве учитывается регистр.The Item[String] property is case-sensitive when searching for names. То есть имена "pname" и "pname" считаются двумя разными свойствами.That is, the names "Pname" and "pname" are considered to be two different properties.

Дополнительно

Применяется к