使用者控制项- Winforms UserControl

最近练习写专案的时候，用到了UserControl类别

其中摸索了很久，如何设定此控制项的属性以供外部，Form类别来取值与设值。

自定义UserControl如下图：

1、想像一下，要如何设定属性，使得此userControl能够像
dataGridView一样，有dataSource得以绑定资料来源？
2、以及如何设定userControl里的dataGridView储存格的值呢？

首先，自定义属性时，我都会先思考，属性的"封闭性"。
到底此属性是只供外部设值，还是只供外部取值，或是两者皆需要。

以我这个专案来说，此dataGridView是准备输出一个的景点的资讯，如下图：

而此dataGridView​的资料来源，实际上是来自Form类别的一个List detailsList物件，因此我只要对外打开属性的setter就行了。

备注：List detailsList物件：用来储存多个景点资讯的集合。

public partial class SpotControl : UserControl
{

 [Category("Custom Props")]
  public List<PlaceDetails> DataSource
  {
   set { dataGridView_eachSpot1.DataSource = value; }
  } 

}

//Form類別裡的TabControls_Selected事件，觸發此事件後，資料在UserControl上輸出


private void TabControls_Selected(object sender, TabControlEventArgs e)
{
   foreach (var placeDetails in detailsList)
   {
     /* 為了只裝1個placeDetails而存在 */
     List<PlaceDetails> details = new List<PlaceDetails>();
     details.Add(placeDetails);
  
     /* 屬性外部設值 */
     spotControl.DataSource = details;
     

}

接下来，再来看如何在Form类别操作UserControl的属性以设定dataGridView储存格的值！

其實並不困難，只要為UserControl設定Columns與Rows屬性，就能在Form類別像使用DataGridView一樣操作。

 public partial class SpotControl : UserControl
    {
        

        [Category("Custom Props")]
        public DataGridViewColumnCollection Columns
        {
            get { return dataGridView_eachSpot1.Columns; }
        }


        [Category("Custom Props")]
        public DataGridViewRowCollection Rows
        {
            get { return dataGridView_eachSpot1.Rows; }
        }

    }

//Form類別裡的TabControls_Selected事件，觸發此事件後，資料在UserControl上輸出


private void TabControls_Selected(object sender, TabControlEventArgs e)
{
   foreach (var placeDetails in detailsList)
   {
     /* 為了只裝1個placeDetails而存在 */
     List<PlaceDetails> details = new List<PlaceDetails>();
     details.Add(placeDetails);
  
     /* 屬性外部設值 */
     spotControl.DataSource = details;

     /* 屬性外部取值 */
     spotControl.Rows[index].Cells[0] .Value= "這只是測試";/******在這裡操作*******/
 
}

运行起来的样子：

这是一个资料补充，在写这个专案的过程，发现已绑定DataSource为List集合的dataGridView，是无法直接为其新增列或值的；
必须将DataSource改为绑定DataTable，再透过将DataTable新增Row来新增dataGridView的资料！

已绑定DataSource的DataGridView若直接新增列，会显示如下图的错误讯息：

Programming: spotControl.Rows.Add();