This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Download Microsoft Edge
More info about Internet Explorer and Microsoft Edge
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; }
[<System.ComponentModel.Browsable(false)>]
member this.Items : System.Windows.Forms.DataGridViewComboBoxCell.ObjectCollection
Public Overridable ReadOnly Property Items As DataGridViewComboBoxCell.ObjectCollection
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
.
