最近練習寫專案的時候,用到了UserControl類别
其中摸索了很久,如何設定此控制項的屬性以供外部,Form類別來取值與設值。
自定義UserControl如下圖:
- 想像一下,要如何設定屬性,使得此userControl能夠像dataGridView一樣,有dataSource得以綁定資料來源?
- 以及如何設定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!