DataGridViewComboBoxColumn.Items プロパティ

.NET Framework クラス ライブラリ リファレンス

DataGridViewComboBoxColumn.Items プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

コンボ ボックスの選択項目として使用されるオブジェクトのコレクションを取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Items As ObjectCollection

Visual Basic (使用法)

Dim instance As DataGridViewComboBoxColumn
Dim value As ObjectCollection

value = instance.Items

C#

public ObjectCollection Items { get; }

C++

public:
property ObjectCollection^ Items {
    ObjectCollection^ get ();
}

J#

/** @property */
public ObjectCollection get_Items ()

JScript

public function get Items
 () : ObjectCollection

プロパティ値
コンボ ボックスの選択項目を表す DataGridViewComboBoxCell.ObjectCollection。

例外

例外の種類	条件
InvalidOperationException	CellTemplate プロパティの値が null 参照 (Visual Basic では Nothing) です。

解説

このプロパティは、CellTemplate プロパティによって返される DataGridViewComboBoxCell の Items プロパティの値を返します。

Items プロパティまたは DataSource プロパティを使用すると、コンボ ボックスの選択項目を決定できます。

Items に文字列を追加する場合は、セル値および表示の両方に追加された各文字列が使用されるため、ValueMember プロパティと DisplayMember プロパティを設定する必要はありません。

メモ
DataGridViewComboBoxColumn では、表示上の値が同じ複数の項目を使用することはできません。

DataSource プロパティを設定する場合、Items は使用できません。

使用例

DataGridViewComboBoxColumn を使用して、TitleOfCourtesy 列へのデータ入力を円滑化するコード例を次に示します。Items プロパティを使用して、ドロップダウン コンボ ボックスに表示するタイトルの選択項目が決定されます。

Visual Basic

Private Shared Sub SetAlternateChoicesUsingItems(
 _
    ByRef comboboxColumn As DataGridViewComboBoxColumn)

    With comboboxColumn
        .Items.AddRange(New String() _
                {"Mr.", "Ms.",
 "Mrs.", "Dr."})
    End With
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

C#

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;
}

C++

private:
    void SetAlternateChoicesUsingItems(
        DataGridViewComboBoxColumn^% comboboxColumn)
    {
        {
            comboboxColumn->Items->AddRange(
                gcnew array<String^> { "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;
    }

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewComboBoxColumn クラス
DataGridViewComboBoxColumn メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridView.DataSource プロパティ
DataGridViewComboBoxColumn.CellTemplate プロパティ
DataGridViewComboBoxCell クラス
DataGridViewComboBoxCell.Items プロパティ
ValueMember
DataGridViewComboBoxColumn.DisplayMember プロパティ
DataGridViewComboBoxColumn.DataSource プロパティ