DataGridViewComboBoxCell.Items Property (System.Windows.Forms)

Property Value

Examples

The following code example demonstrates the use of the DataGridViewComboBoxColumn.Items property, which is similar to this property. 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
     
      Remarks
     
     
      This property enables you to obtain a reference to the list of items that are currently stored in the
      
       DataGridViewComboBoxCell
      
      . With this reference, you can add items, remove items, and obtain a count of the items in the collection. For more information on the tasks that can be performed with the
      
       Items
      
      collection, see
      
       DataGridViewComboBoxCell.ObjectCollection
      
      .
     
     
      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.
     
     
      
       DataGridViewComboBoxCell
      
      does not support the use of multiple items with identical display values.
     
     
      If the
      
       DataSource
      
      property is set, then the
      
       Items
      
      property cannot be used.
     
     
      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. You can customize this behavior by handling the
      
       DataGridView.DataError
      
      and
      
       DataGridView.CellFormatting
      
      events.
     
     
      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. For more information about row sharing, see
      
       Best Practices for Scaling the Windows Forms DataGridView Control
      
      .