C#开发WinForm之DataGridView开发详解

时间:2021-01-14 陈袁人气:0

这篇文章主要介绍了C#开发WinForm之DataGridView开发详解，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧

前言

DataGridView是开发Winform的一个列表展示，类似于表格。学会下面的基本特征用法，再辅以经验，基本功能开发没问题。

基本的数据渲染

根据提供的数据展示出效果。

提供给DataGridView数据源有很多方式，大致有如下三种：

直接增加，每个单元格类型都是`DataGridViewTextBoxCell`

int index=this.dataGridView1.Rows.Add();
this.dataGridView1.Rows[index].Cells[0].Value = "1";
this.dataGridView1.Rows[index].Cells[1].Value = "2";
this.dataGridView1.Rows[index].Cells[2].Value = "3";

直接增加一行，在行上的每天单元格内添加数据，缺点是太单一

直接增加，但我们可以指定单元格类型

DataGridViewRow row = new DataGridViewRow();
DataGridViewTextBoxCell textboxcell = new DataGridViewTextBoxCell();
textboxcell.Value = "aaa";
row.Cells.Add(textboxcell);
DataGridViewComboBoxCell comboxcell = new DataGridViewComboBoxCell();
row.Cells.Add(comboxcell);
dataGridView1.Rows.Add(row);

可选的类型如下图：

在这里插入图片描述

使用vo对象

上面2种都不是我想要的，因为列表展示的数据大部分情况下是复杂的后台回传的数据。所以我建议使用Vo。
新建InfoVo.cs类

public class InfoVo
 {
  /// <summary>
  /// 
  /// </summary>
  public string uidItem { get; set; }
  /// <summary>
  /// 
  /// </summary>
  public string uidItemRevision { get; set; }
  /// <summary>
  /// 
  /// </summary>
  public string primaryTag { get; set; }
 }

构造一个List，将InfoVo放进List对象里，然后将List对象赋值给dataGridView.DataSource即可。
在窗体的Load事件里添加如下代码

private void SearchInfo_Load(object sender, EventArgs e)
  {
  	List<InfoVo> list = new List<InfoVo>();
    list.Add(new InfoVo(){ uidItem="1", uidItemRevision ="1", primaryTag ="1"});
    list.Add(new InfoVo(){ uidItem="2", uidItemRevision ="2", primaryTag ="2"});
    dataGridView.AutoGenerateColumns = false;
    dataGridView.DataSource = null;
    dataGridView.DataSource = list;
  }

直接赋值dataGridView.DataSource = list即可。这里的AutoGenerateColumns是禁止dataGridView自动根据vo属性创建列。

在窗体上选中DataGridView,在属性面板里点击Columns选项。如下图

在这里插入图片描述

在打开的面板里，我们可以创建列。选择是否可见，设置抬头
DataPropertyName：指定列绑定的数据源属性字段。
在DolumnType里我们可以指定单元格类型，如下图

在这里插入图片描述

比如下拉框，或者单元框。
至此，我们可以渲染出DataGridView组件里，下面看一些属性。

dataGridView

列宽自适应

foreach (DataGridViewColumn column in dataGridView.Columns)
 {
  column.AutoSizeMode = DataGridViewAutoSizeColumnMode.AllCells;
 }

成员名称	说明
NotSet	列的大小调整行为从DataGridView.AutoSizeColumnsMode 属性继承。
None	列宽不会自动调整。
AllCells	调整列宽，以适合该列中的所有单元格的内容，包括标题单元格。
AllCellsExceptHeader	调整列宽，以适合该列中的所有单元格的内容，不包括标题单元格。
DisplayedCells	调整列宽，以适合当前屏幕上显示的行的列中的所有单元格的内容，包括标题单元格。
DisplayedCellsExceptHeader	调整列宽，以适合当前屏幕上显示的行的列中的所有单元格的内容，不包括标题单元格。
ColumnHeader	调整列宽，以适合列标题单元格的内容。
Fill	调整列宽，使所有列的宽度正好填充控件的显示区域，只需要水平滚动保证列宽在DataGridViewColumn.MinimumWidth属性值以上。相对列宽由相对DataGridViewColumn.FillWeight属性值决定。

如果想让列宽能按比例填充显示区域则 column.AutoSizeMode = DataGridViewAutoSizeColumnMode.Fill;

禁止缩放单元格大小

2个属性

AllowUserToResizeColumns:true:禁止缩放列
AllowUserToResizeRows:true:禁止缩放行

用户自定义列的顺序

用户可以拖动的方式排序列展示
AllowUserToOrderColumns:true

是否可以编辑单元格

窗体的ReadOnly为false
在Columns弹出的列编辑窗口里，选择列的ReadOnly为false
SelectionMode为RowReadSelect(这是默认值)

行头，列头不显示

在属性面板里选中RowheadersVisible和ColumnHeadersVisible，置为false

列表显示不完全，必需鼠标移到组件上才能显示的bug

将RowheadersVisible置为false即可。

行头显示行号

为RowStateChanged事件添加监听，（在属性面板右边闪电图标下找）。

private void dataGridView1_RowStateChanged(object sender, DataGridViewRowStateChangedEventArgs e)
{
 //显示在HeaderCell上
 for (int i = 0; i < this.dataGridView1.Rows.Count; i++)
 {
  DataGridViewRow r = this.dataGridView1.Rows[i];
  r.HeaderCell.Value = string.Format("{0}", i + 1);
 }
 this.dataGridView1.Refresh();
}

行号没有完全显示出来的解决办法是将DataGridView的RowHeadersWidthSizeMode属性设置为AutoSizeToAllHeaders、AutoSizeToDisplayedHeaders或者AutoSizeToFirstHeader。

禁止自动创建列

如果我们提供的vo对象，dataGrid会自动根据属性创建列，这不是我想要的，我希望能控制显示。如下设置即可
dataGridView.AutoGenerateColumns = false;

修改单元格类型

单元格可以显示文件，也可以显示单元框，下拉框，图片和超链拉。只要在编辑列窗口里选择ColumnType下拉框，选择一下即可。当然选择的不同，数据设置不同，比如
单选框DataGridViewCheckBoxColumn如下

在这里插入图片描述

下拉框DataGridViewComboBoxColumn

在这里插入图片描述

选中模式

可以指定选中是整个行被选中还是每个小单元格被选中
SelectionMode，全部可选如下

在这里插入图片描述

其它

当然还有其它，只要我们熟悉，在属性面板上几乎都能找到。

选中事件

CellClick是选中事件，不用它即可，不要用CellContentClick，因为如果单元格无内容，这个CellContentClick事件不会触发。

取得当前单元格内容：DataGridView1.CurrentCell.Value
取得当前单元格的列 Index：DataGridView1.CurrentCell.ColumnIndex
取得当前单元格的行 Index：DataGridView1.CurrentCell.RowIndex
取得当前行：dataGridView.CurrentRow;
获得绑定的vo：

DataGridViewRow dataGridViewRow = dataGridView.CurrentRow;
   InfoVo infoVo = dataGridViewRow.DataBoundItem as InfoVo ;
   infoVo .uidItemRevision ;

如果表格可编辑，那么编辑完表格会同步更新DataBoundItem绑定的vo对象

遍历列表里所有单元格

	foreach (DataGridViewRow item in dataGridView.Rows)
   {
     //item是每行的对象，cells是单元格集合
    if (null != item.Cells[0].Value && (Boolean)item.Cells[0].Value)
    {
			item.Cells[0].Value.toString();
		}
	}

使用 DataGridView.CurrentCellAddress 属性（而不是直接访问单元格）来确定单元格所在的
行： DataGridView.CurrentCellAddress.Y
列： DataGridView.CurrentCellAddress.X 。

当前的单元格可以通过设定 DataGridView 对象的 CurrentCell 来改变。可以通过 CurrentCell 来设定
DataGridView 的激活单元格。将 CurrentCell 设为 Nothing(null) 可以取消激活的单元格。

DataGridView DataGridViewCheckBoxColumn编辑时实时触发事件

正常响应CellValueChanged()事件时，当改变checkbox状态时，只有当焦点离开该单元格时才能触发CellValueChanged()事件，

如果要改变checkbox值时实时触发CellValueChanged()事件，需要借用CurrentCellDirtyStateChanged()事件来提交未提交控件的更改。

private void dataGridView1_CurrentCellDirtyStateChanged(object sender, EventArgs e)
  {
   if (dataGridView1.IsCurrentCellDirty)
   {
    dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit);
   }
  }

事实上，当调用dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit);时，就提交了当前的修改，很多其它事件都会有响应，其中CellValueChanged就是其中之一。
这样CellValueChanged()事件就可以随着checkbox的值的改变实时触发。
以全选/反选为例说明当DataGridViewCheckBoxColumn发生变化时怎么处理全选/反选。
CheckBox有3种状态：选中(CheckState.Checked)/取消(CheckState.Unchecked)/部分选中(CheckState.Indeterminate)
在winForm组件里拖拽一个CheckBox命名为selectAllCheckBox，Text为全选，拖拽一个LinkLabel命名为revSelectLinkLbl，Text为反选。

 //全选
  private void selectAllCheckBox_CheckedChanged(object sender, EventArgs e)
  {
   CheckBox c = sender as CheckBox;
   if(c.CheckState == CheckState.Checked)
   {
    ChangeDataSourceChecked(true);
   }
   else if(c.CheckState == CheckState.Unchecked)
   {
    ChangeDataSourceChecked(false);
   }
  }

  private void ChangeDataSourceChecked(Boolean isSelected)
  {
   foreach (SavePlmBomResponseVo savePlmBomResponseVo in dataSource)
   {
    savePlmBomResponseVo.checkedC = isSelected;
   }
   dataGridView.DataSource = null;
   dataGridView.DataSource = dataSource;
  }
  /// <summary>
  /// 反选
  /// </summary>
  /// <param name="sender"></param>
  /// <param name="e"></param>
  private void revSelectLinkLbl_LinkClicked(object sender, LinkLabelLinkClickedEventArgs e)
  {
   if (this.selectAllCheckBox.CheckState == CheckState.Checked)
   {
    this.selectAllCheckBox.CheckState = CheckState.Unchecked;
   }
   else if(this.selectAllCheckBox.CheckState == CheckState.Unchecked)
   {
    this.selectAllCheckBox.CheckState = CheckState.Checked;
   }
   else
   {
    //部分选中
    foreach (SavePlmBomResponseVo savePlmBomResponseVo in dataSource)
    {
     if (savePlmBomResponseVo.checkedC)
     {
      savePlmBomResponseVo.checkedC = false;
     }
     else
     {
      savePlmBomResponseVo.checkedC = true;
     }
    }
    dataGridView.DataSource = null;
    dataGridView.DataSource = dataSource;
   }
  }

  /// <summary>
  /// 处理DataSource数据变化时，全选/反选选中状态
  /// </summary>
  private void calSelectAllCheckBoxState()
  {
   int selectedCount = 0;
   foreach (SavePlmBomResponseVo savePlmBomResponseVo in dataSource)
   {
    if (savePlmBomResponseVo.checkedC)
    {
     ++selectedCount;
    }
   }
   if (selectedCount == 0)
   {
    if(this.selectAllCheckBox.CheckState != CheckState.Unchecked)
    {
     this.selectAllCheckBox.CheckState = CheckState.Unchecked;
    }
   }
   else if (selectedCount == dataSource.Count)
   {
    if (this.selectAllCheckBox.CheckState != CheckState.Checked)
    {
     this.selectAllCheckBox.CheckState = CheckState.Checked;
    }
   }
   else
   {
    if (this.selectAllCheckBox.CheckState != CheckState.Indeterminate)
    {
     this.selectAllCheckBox.CheckState = CheckState.Indeterminate;
    }
   }
  }

  /// <summary>
  /// 提交修改状态
  /// </summary>
  /// <param name="sender"></param>
  /// <param name="e"></param>
  private void DataGridView_CurrentCellDirtyStateChanged(object sender, EventArgs e)
  {
   if (this.dataGridView.IsCurrentCellDirty)
   {
    this.dataGridView.CommitEdit(DataGridViewDataErrorContexts.Commit);
   }
  }

  //行值变化
  private void DataGridView_CellValueChanged(object sender, DataGridViewCellEventArgs e)
  {
   calSelectAllCheckBoxState();
  }

加载全部内容

C#开发WinForm之DataGridView开发详解

前言

基本的数据渲染

直接增加，每个单元格类型都是DataGridViewTextBoxCell

直接增加，但我们可以指定单元格类型

使用vo对象

dataGridView

列宽自适应

禁止缩放单元格大小

用户自定义列的顺序

是否可以编辑单元格

行头，列头不显示

列表显示不完全，必需鼠标移到组件上才能显示的bug

行头显示行号

禁止自动创建列

修改单元格类型

选中模式

其它

选中事件

DataGridView DataGridViewCheckBoxColumn编辑时实时触发事件

直接增加，每个单元格类型都是`DataGridViewTextBoxCell`