DataGridViewComboBoxCell.Items 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取对象，这些对象表示下拉列表中显示的选项。

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

属性值

DataGridViewComboBoxCell.ObjectCollection

包含选项的 DataGridViewComboBoxCell.ObjectCollection。

属性

BrowsableAttribute

示例

下面的代码示例演示如何使用 DataGridViewComboBoxColumn.Items 属性，该属性类似于此属性。 此示例是类概述主题中提供的更大示例的 DataGridViewComboBoxColumn 一部分。

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

注解

此属性使你能够获取对当前存储在 中的项列表的 DataGridViewComboBoxCell引用。 使用此引用，可以添加项、删除项以及获取集合中项的计数。 有关可以使用 集合执行 Items 的任务的详细信息，请参阅 DataGridViewComboBoxCell.ObjectCollection。

如果将字符串添加到 Items，则 ValueMember 不需要设置 和 DisplayMember ，因为添加的每个字符串都将用于值和显示。

注意

DataGridViewComboBoxCell 不支持使用具有相同显示值的多个项。

DataSource如果设置了 属性，则Items不能使用该属性。

单元格的格式化值必须始终是集合中的Items值之一，否则会发生错误，并且单元格值将还原到集合中的第一项。 可以通过处理 DataGridView.DataError 和 DataGridView.CellFormatting 事件来自定义此行为。

将此属性设置为父列 Items 属性的值以外的值将强制该行取消共享，从而分配额外的内存。 有关行共享的详细信息，请参阅缩放 Windows 窗体 DataGridView 控件的最佳做法。

另请参阅

• DataGridView
• Items
• Value
• DisplayMember
• 缩放 Windows 窗体 DataGridView 控件的最佳做法