DataGridViewComboBoxCell.Items Proprietà

Definizione

Ottiene gli oggetti che rappresentano la selezione visualizzata nell'elenco a discesa.Gets the objects that represent the selection displayed in the drop-down list.

public:
 virtual property System::Windows::Forms::DataGridViewComboBoxCell::ObjectCollection ^ Items { System::Windows::Forms::DataGridViewComboBoxCell::ObjectCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual System.Windows.Forms.DataGridViewComboBoxCell.ObjectCollection Items { get; }
member this.Items : System.Windows.Forms.DataGridViewComboBoxCell.ObjectCollection
Public Overridable ReadOnly Property Items As DataGridViewComboBoxCell.ObjectCollection

Valore della proprietà

Attributi

Esempi

Nell'esempio di codice riportato di seguito viene illustrato DataGridViewComboBoxColumn.Items l'utilizzo della proprietà, che è simile a questa proprietà.The following code example demonstrates the use of the DataGridViewComboBoxColumn.Items property, which is similar to this property. Questo esempio fa parte di un esempio più ampio disponibile nell' DataGridViewComboBoxColumn argomento Panoramica della classe.This example is part of a larger example available in the DataGridViewComboBoxColumn class overview topic.

private:
    void SetAlternateChoicesUsingItems(
        DataGridViewComboBoxColumn^ comboboxColumn)
    {
        comboboxColumn->Items->AddRange("Mr.", "Ms.", "Mrs.", "Dr.");
    }

private:
    DataGridViewComboBoxColumn^ CreateComboBoxColumn()
    {
        DataGridViewComboBoxColumn^ column =
            gcnew DataGridViewComboBoxColumn();
        {
            column->DataPropertyName = ColumnName::TitleOfCourtesy.ToString();
            column->HeaderText = ColumnName::TitleOfCourtesy.ToString();
            column->DropDownWidth = 160;
            column->Width = 90;
            column->MaxDropDownItems = 3;
            column->FlatStyle = FlatStyle::Flat;
        }
        return column;
    }
private static void SetAlternateChoicesUsingItems(
    DataGridViewComboBoxColumn comboboxColumn)
{
    comboboxColumn.Items.AddRange("Mr.", "Ms.", "Mrs.", "Dr.");
}

private DataGridViewComboBoxColumn CreateComboBoxColumn()
{
    DataGridViewComboBoxColumn column =
        new DataGridViewComboBoxColumn();
    {
        column.DataPropertyName = ColumnName.TitleOfCourtesy.ToString();
        column.HeaderText = ColumnName.TitleOfCourtesy.ToString();
        column.DropDownWidth = 160;
        column.Width = 90;
        column.MaxDropDownItems = 3;
        column.FlatStyle = FlatStyle.Flat;
    }
    return column;
}
Private Shared Sub SetAlternateChoicesUsingItems( _
    ByVal comboboxColumn As DataGridViewComboBoxColumn)

    comboboxColumn.Items.AddRange("Mr.", "Ms.", "Mrs.", "Dr.")

End Sub

Private Function CreateComboBoxColumn() _
    As DataGridViewComboBoxColumn
    Dim column As New DataGridViewComboBoxColumn()

    With column
        .DataPropertyName = ColumnName.TitleOfCourtesy.ToString()
        .HeaderText = ColumnName.TitleOfCourtesy.ToString()
        .DropDownWidth = 160
        .Width = 90
        .MaxDropDownItems = 3
        .FlatStyle = FlatStyle.Flat
    End With
    Return column
End Function

Commenti

Questa proprietà consente di ottenere un riferimento all'elenco di elementi attualmente archiviati in DataGridViewComboBoxCell.This property enables you to obtain a reference to the list of items that are currently stored in the DataGridViewComboBoxCell. Con questo riferimento, è possibile aggiungere elementi, rimuovere elementi e ottenere un conteggio degli elementi nella raccolta.With this reference, you can add items, remove items, and obtain a count of the items in the collection. Per ulteriori informazioni sulle attività che possono essere eseguite con la Items raccolta, vedere. DataGridViewComboBoxCell.ObjectCollectionFor more information on the tasks that can be performed with the Items collection, see DataGridViewComboBoxCell.ObjectCollection.

Se ValueMember le stringhe vengono aggiunte Itemsa, non DisplayMember è necessario impostare e, perché ogni stringa aggiunta verrà utilizzata per il valore e la visualizzazione.If strings are added to Items, then ValueMember and DisplayMember do not need to be set because each string added will be used for both value and display.

Nota

DataGridViewComboBoxCellnon supporta l'utilizzo di più elementi con valori di visualizzazione identici.DataGridViewComboBoxCell does not support the use of multiple items with identical display values.

Se la DataSource proprietà è impostata, la Items proprietà non può essere utilizzata.If the DataSource property is set, then the Items property cannot be used.

Il valore formattato della cella deve essere sempre uno dei valori Items della raccolta, altrimenti si verificherà un errore e il valore della cella verrà ripristinato al primo elemento della raccolta.The formatted value of the cell must always be one of the values in the Items collection or an error will occur and the cell value will revert to the first item in the collection. È possibile personalizzare questo comportamento gestendo gli DataGridView.DataError eventi DataGridView.CellFormatting e.You can customize this behavior by handling the DataGridView.DataError and DataGridView.CellFormatting events.

Se si imposta questa proprietà su un valore diverso dal valore della Items proprietà della colonna padre, la riga verrà annullata, allocando memoria aggiuntiva.Setting this property to a value other than the value of the parent column's Items property will force the row to become unshared, allocating extra memory. Per ulteriori informazioni sulla condivisione delle righe, vedere procedure consigliate per la scalabilità del controllo Windows Forms DataGridView.For more information about row sharing, see Best Practices for Scaling the Windows Forms DataGridView Control.

Si applica a

Vedi anche