DataGridViewComboBoxCell.Items Eigenschaft

Definition

Ruft die Objekte ab, die die in der Dropdownliste angezeigte Auswahl darstellen.

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

Eigenschaftswert

Eine DataGridViewComboBoxCell.ObjectCollection, die die Auswahl enthält.

Attribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der DataGridViewComboBoxColumn.Items -Eigenschaft veranschaulicht, die dieser Eigenschaft ähnelt. Dieses Beispiel ist Teil eines größeren Beispiels, das DataGridViewComboBoxColumn im Thema Klassenübersicht verfügbar ist.

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

Hinweise

Mit dieser Eigenschaft können Sie einen Verweis auf die Liste der Elemente abrufen, die derzeit in DataGridViewComboBoxCellgespeichert sind. Mit diesem Verweis können Sie Elemente hinzufügen, Elemente entfernen und eine Anzahl der Elemente in der Auflistung abrufen. Weitere Informationen zu den Aufgaben, die mit der Items Auflistung ausgeführt werden können, finden Sie unter DataGridViewComboBoxCell.ObjectCollection.

Wenn Zeichenfolgen ValueMember hinzugefügt werden, Itemsmüssen und DisplayMember nicht festgelegt werden, da jede hinzugefügte Zeichenfolge sowohl für den Wert als auch für die Anzeige verwendet wird.

Hinweis

DataGridViewComboBoxCell unterstützt nicht die Verwendung mehrerer Elemente mit identischen Anzeigewerten.

Wenn die DataSource -Eigenschaft festgelegt ist, kann die Items -Eigenschaft nicht verwendet werden.

Der formatierte Wert der Zelle muss immer einer der Werte in der Items Auflistung sein, sonst tritt ein Fehler auf, und der Zellwert wird zum ersten Element in der Auflistung rückgängig machen. Sie können dieses Verhalten anpassen, indem Sie die DataGridView.DataError Ereignisse und DataGridView.CellFormatting behandeln.

Wenn Sie diese Eigenschaft auf einen anderen Wert als den Wert der Eigenschaft der übergeordneten Spalte Items festlegen, wird erzwungen, dass die Zeile aufgehoben wird und zusätzlicher Arbeitsspeicher zugewiesen wird. Weitere Informationen zum Freigeben von Zeilen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.

Gilt für:

Weitere Informationen