DataGridViewColumn.DataPropertyName Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

DataGridViewColumn.cs

Ruft den Namen der Datenquelleneigenschaft oder Datenbankspalte ab, an die DataGridViewColumn gebunden ist, oder legt diesen Namen fest.

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

Eigenschaftswert

String

Der Name der Eigenschaft oder Datenbankspalte, die der DataGridViewColumn zugeordnet ist, bei dem die Groß-/Kleinschreibung beachtet wird.

Attribute

BrowsableAttribute TypeConverterAttribute

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie auswählen, welche Eigenschaft die einzelnen Spalten darstellen sollen.

public enum Title
{
    King,
    Sir
};

private void EnumsAndComboBox_Load(object sender, System.EventArgs e)
{
    // Populate the data source.
    bindingSource1.Add(new Knight(Title.King, "Uther", true));
    bindingSource1.Add(new Knight(Title.King, "Arthur", true));
    bindingSource1.Add(new Knight(Title.Sir, "Mordred", false));
    bindingSource1.Add(new Knight(Title.Sir, "Gawain", true));
    bindingSource1.Add(new Knight(Title.Sir, "Galahad", true));

    // Initialize the DataGridView.
    dataGridView1.AutoGenerateColumns = false;
    dataGridView1.AutoSize = true;
    dataGridView1.DataSource = bindingSource1;

    dataGridView1.Columns.Add(CreateComboBoxWithEnums());

    // Initialize and add a text box column.
    DataGridViewColumn column = new DataGridViewTextBoxColumn();
    column.DataPropertyName = "Name";
    column.Name = "Knight";
    dataGridView1.Columns.Add(column);

    // Initialize and add a check box column.
    column = new DataGridViewCheckBoxColumn();
    column.DataPropertyName = "GoodGuy";
    column.Name = "Good";
    dataGridView1.Columns.Add(column);

    // Initialize the form.
    this.Controls.Add(dataGridView1);
    this.AutoSize = true;
    this.Text = "DataGridView object binding demo";
}

DataGridViewComboBoxColumn CreateComboBoxWithEnums()
{
    DataGridViewComboBoxColumn combo = new DataGridViewComboBoxColumn();
    combo.DataSource = Enum.GetValues(typeof(Title));
    combo.DataPropertyName = "Title";
    combo.Name = "Title";
    return combo;
}
#region "business object"
private class Knight
{
    private string hisName;
    private bool good;
    private Title hisTitle;

    public Knight(Title title, string name, bool good)
    {
        hisTitle = title;
        hisName = name;
        this.good = good;
    }

    public Knight()
    {
        hisTitle = Title.Sir;
        hisName = "<enter name>";
        good = true;
    }

    public string Name
    {
        get
        {
            return hisName;
        }

        set
        {
            hisName = value;
        }
    }

    public bool GoodGuy
    {
        get
        {
            return good;
        }
        set
        {
            good = value;
        }
    }

    public Title Title
    {
        get
        {
            return hisTitle;
        }
        set
        {
            hisTitle = value;
        }
    }
}
#endregion

Hinweise

Wenn die AutoGenerateColumns -Eigenschaft auf truefestgelegt ist, legt jede Spalte ihre DataPropertyName Eigenschaft automatisch auf den Namen einer Eigenschaft oder Datenbankspalte in der von der DataSource -Eigenschaft angegebenen Datenquelle fest. Diese Bindung kann auch manuell ausgeführt werden. Dies ist hilfreich, wenn Sie nur eine Teilmenge der in der Datenquelle verfügbaren Eigenschaften oder Datenbankspalten anzeigen möchten. Legen Sie in solchen Fällen die AutoGenerateColumns -Eigenschaft auf falsefest, und fügen Sie dann manuell jede DataGridViewColumnhinzu, und legen Sie den Wert jeder DataPropertyName Eigenschaft auf die Eigenschaften oder Datenbankspalten in der Datenquelle fest, die Sie anzeigen möchten.

Gilt für:

Weitere Informationen

• DataGridView
• ColumnDataPropertyNameChanged