DataGridViewColumn.DataPropertyName Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

DataGridViewColumn.cs

bağlı olduğu veri kaynağı özelliğinin veya veritabanı sütununun DataGridViewColumn adını alır veya ayarlar.

C#

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

Özellik Değeri

String

ile DataGridViewColumnilişkili özellik veya veritabanı sütununun büyük/küçük harfe duyarlı olmayan adı.

Öznitelikler

BrowsableAttribute TypeConverterAttribute

Örnekler

Aşağıdaki kod örneği, her sütunun hangi özelliği temsil edeceğinin nasıl seçileceğini gösterir.

C#

public enum Title
{
    King,
    Sir
};

C#

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

Açıklamalar

AutoGenerateColumns özelliği olarak ayarlandığındatrue, her sütun otomatik olarak özelliğini özelliği tarafından belirtilen veri kaynağındaki bir özellik veya veritabanı sütununun DataSource adına ayarlarDataPropertyName. Bu bağlama el ile de gerçekleştirilebilir. Bu, veri kaynağında kullanılabilen özelliklerin veya veritabanı sütunlarının yalnızca bir alt kümesini görüntülemek istediğinizde kullanışlıdır. Bu gibi durumlarda, özelliğini olarak falseayarlayın AutoGenerateColumns ve ardından her DataGridViewColumnbir özelliğin DataPropertyName değerini, görüntülemek istediğiniz veri kaynağındaki özelliklere veya veritabanı sütunlarına ayarlayarak el ile ekleyin.

Şunlara uygulanır

Ayrıca bkz.

• DataGridView
• ColumnDataPropertyNameChanged