This documentation is archived and is not being maintained.

DataGridViewComboBoxColumn.Items Property

Note: This property is new in the .NET Framework version 2.0.

Gets the collection of objects used as selections in the combo boxes.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public ObjectCollection Items { get; }
/** @property */
public ObjectCollection get_Items ()

public function get Items () : ObjectCollection

Property Value

An DataGridViewComboBoxCell.ObjectCollection that represents the selections in the combo boxes.

Exception typeCondition

InvalidOperationException

The value of the CellTemplate property is a null reference (Nothing in Visual Basic).

This property returns the value of the Items property of the DataGridViewComboBoxCell returned by the CellTemplate property.

The Items or DataSource properties are used to populate the selections of the combo boxes.

If strings are added to Items, then the ValueMember and DisplayMember properties do not need to be set because each string added will be used for both value and display.

NoteNote

DataGridViewComboBoxColumn does not support the use of multiple items with identical display values.

If the DataSource property is set, then Items cannot be used.

The following code example demonstrates how to use a DataGridViewComboBoxColumn to aid in entering data into the TitleOfCourtesy column. The Items property is used to populate the combo box drop-down list with a selection of titles.

private static void SetAlternateChoicesUsingItems(
    ref DataGridViewComboBoxColumn comboboxColumn)
{
    {
        comboboxColumn.Items.AddRange(
            new string[] { "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;
}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Show: