DataGridViewComboBoxCell.Items Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Objekte ab, die die Auswahl darstellen, die in der Dropdownliste angezeigt wird.
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.ObjectCollectionPublic Overridable ReadOnly Property Items As DataGridViewComboBoxCell.ObjectCollectionEigenschaftswert
Ein DataGridViewComboBoxCell.ObjectCollection Element, das 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 der DataGridViewComboBoxCell. 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 Sammlung ausgeführt werden können, finden Sie unter DataGridViewComboBoxCell.ObjectCollection.
Wenn Zeichenfolgen hinzugefügt Itemswerden, ValueMember müssen sie DisplayMember nicht festgelegt werden, da jede hinzugefügte Zeichenfolge sowohl für 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, oder ein Fehler tritt auf, und der Zellwert wird auf das erste Element in der Auflistung zurückgesetzt. Sie können dieses Verhalten anpassen, indem Sie die DataGridView.DataError Ereignisse 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 nicht mehr freigegeben wird und zusätzlichen Arbeitsspeicher zugewiesen wird. Weitere Informationen zur Zeilenfreigabe finden Sie unter Best Practices for Scaling the Windows Forms DataGridView Control.
