使用者控制項 - Winforms UserControl

最近練習寫專案的時候,用到了UserControl類别

其中摸索了很久,如何設定此控制項的屬性以供外部,Form類別來取值與設值。

自定義UserControl如下圖:

  1. 想像一下,要如何設定屬性,使得此userControl能夠像dataGridView一樣,有dataSource得以綁定資料來源?
  2. 以及如何設定userControl裡的dataGridView儲存格的值呢?

首先,自定義屬性時,我都會先思考,屬性的"封閉性"。
到底此屬性是只供外部設值,還是只供外部取值,或是兩者皆需要。

以我這個專案來說,此dataGridView是準備輸出一個的景點的資訊,如下圖:
而此dataGridView​的資料來源,實際上是來自Form類別的一個List<PlaceDetails> detailsList物件,因此我只要對外打開屬性的setter就行了。

備註:List<PlaceDetails> 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的資料!
參考來源:https://stackoverflow.com/questions/31262386/cannot-add-rows-to-my-data-bound-datagridview-dynamically

已綁定DataSource的DataGridView若直接新增列,會顯示如下圖的錯誤訊息:

Programming: spotControl.Rows.Add();

 

如有敘述錯誤,還請不吝嗇留言指教,thanks!