DataGridViewComboBoxColumn.DisplayMember Propriété

Définition

Obtient ou définit une chaîne qui spécifie la propriété ou la colonne à partir de laquelle les chaînes sont récupérées pour l'affichage dans les zones de liste déroulante.

[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataMemberFieldConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string DisplayMember { get; set; }
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataMemberFieldConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string DisplayMember { get; set; }
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataMemberFieldConverter, System.Windows.Forms.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string DisplayMember { get; set; }

Valeur de propriété

Un String qui spécifie le nom d'une propriété ou d'une colonne dans la source de données spécifiée dans la propriété DataSource. La valeur par défaut est Empty.

Attributs

Exceptions

La propriété CellTemplate possède la valeur null.

Exemples

L’exemple de code suivant montre comment utiliser un DataGridViewComboBoxColumn pour faciliter la saisie de données de la colonne de titre. DisplayMember est défini sur le nom de propriété responsable de contenir le texte visible par l’utilisateur. Dans cet exemple, le DisplayMember est défini sur la même valeur que ValueMember parce qu’aucun mappage n’est nécessaire. Cet exemple fait partie d’un exemple plus large disponible dans la rubrique vue d’ensemble de la DataGridViewComboBoxColumn classe.

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 void SetAlternateChoicesUsingDataSource(DataGridViewComboBoxColumn comboboxColumn)
{
    {
        comboboxColumn.DataSource = RetrieveAlternativeTitles();
        comboboxColumn.ValueMember = ColumnName.TitleOfCourtesy.ToString();
        comboboxColumn.DisplayMember = comboboxColumn.ValueMember;
    }
}

private DataTable RetrieveAlternativeTitles()
{
    return Populate("SELECT distinct TitleOfCourtesy FROM Employees");
}

string connectionString =
    "Integrated Security=SSPI;Persist Security Info=False;" +
    "Initial Catalog=Northwind;Data Source=localhost";

private DataTable Populate(string sqlCommand)
{
    SqlConnection northwindConnection = new SqlConnection(connectionString);
    northwindConnection.Open();

    SqlCommand command = new SqlCommand(sqlCommand, northwindConnection);
    SqlDataAdapter adapter = new SqlDataAdapter();
    adapter.SelectCommand = command;

    DataTable table = new DataTable();
    table.Locale = System.Globalization.CultureInfo.InvariantCulture;
    adapter.Fill(table);

    return table;
}

// Using an enum provides some abstraction between column index
// and column name along with compile time checking, and gives
// a handy place to store the column names.
enum ColumnName
{
    EmployeeId,
    LastName,
    FirstName,
    Title,
    TitleOfCourtesy,
    BirthDate,
    HireDate,
    Address,
    City,
    Region,
    PostalCode,
    Country,
    HomePhone,
    Extension,
    Photo,
    Notes,
    ReportsTo,
    PhotoPath,
    OutOfOffice
};

Remarques

Les données des valeurs stockées dans une colonne d’objets DataGridViewComboBoxCell sont obtenues à partir de .DataGridView.DataSource Si ces données proviennent d’une propriété ou d’une colonne non par défaut, la DisplayMember propriété doit être définie sur le nom de la propriété ou le nom de colonne nécessaire.

Si les valeurs de cellule sont des valeurs internes non visibles par l’utilisateur, utilisez DisplayMember et ValueMember pour mapper les valeurs de cellule internes aux valeurs visibles par l’utilisateur.

Lorsque la DataSource propriété est définie sur un tableau de chaînes, la DisplayMember propriété n’a pas besoin d’être définie, car chaque chaîne du tableau sera utilisée comme chaîne d’affichage valide et comme valeur sous-jacente valide.

L’obtention ou la définition de cette propriété obtient ou définit la DisplayMember propriété de l’objet retourné par la CellTemplate propriété . La définition de cette propriété définit également la DisplayMember propriété de chaque cellule de la colonne et actualise l’affichage des colonnes. Pour remplacer la valeur spécifiée pour les cellules individuelles, définissez les valeurs de cellule après avoir défini la valeur de colonne.

S’applique à

Produit Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Voir aussi