Winform控制項綁定數據

来源:https://www.cnblogs.com/timefiles/archive/2022/11/22/16913627.html
-Advertisement-
Play Games

簡介 在C#中提起控制項綁定數據,大部分人首先想到的是WPF,其實Winform也支持控制項和數據的綁定。 Winform中的數據綁定按控制項類型可以分為以下幾種: 簡單控制項綁定 列表控制項綁定 表格控制項綁定 綁定基類 綁定數據類必須實現INotifyPropertyChanged介面,否則數據類屬性的變更 ...


目錄

簡介

在C#中提起控制項綁定數據,大部分人首先想到的是WPF,其實Winform也支持控制項和數據的綁定。

Winform中的數據綁定按控制項類型可以分為以下幾種:

  • 簡單控制項綁定
  • 列表控制項綁定
  • 表格控制項綁定

綁定基類

綁定數據類必須實現INotifyPropertyChanged介面,否則數據類屬性的變更無法實時刷新到界面,但可以從界面刷新到類。
為了方便,我們設計一個綁定基類:

/// <summary>
/// 數據綁定基類
/// </summary>
public abstract class BindableBase : INotifyPropertyChanged
{
    public event PropertyChangedEventHandler PropertyChanged;
    protected bool SetProperty<T>(ref T field, T newValue, [CallerMemberName] string propertyName = null)
    {
        if (!EqualityComparer<T>.Default.Equals(field, newValue))
        {
            field = newValue;
            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
            return true;
        }
        return false;
    }
}

需要綁定的數據類繼承綁定基類即可:

/// <summary>
/// 數據類
/// </summary>
public class Data : BindableBase
{
    private int id = 0;
    private string name = string.Empty;

    public int ID      { get => id;   set => SetProperty(ref id, value); }
    public string Name { get => name; set => SetProperty(ref name, value); }
}

功能擴展

主要為綁定基類擴展了以下兩個功能:

  • 獲取屬性的Description特性內容
  • 從指定類載入屬性值,對象直接賦值是賦值的引用,控制項綁定的數據源還是之前的對象

這兩個功能不屬於綁定基類的必要功能,但可以為綁定提供方便,所以單獨放在擴展方法類裡面。
代碼如下:

/// <summary>
/// 數據綁定基類的擴展方法
/// </summary>
public static class BindableBaseExtension
{
   
    /// <summary>
    /// 獲取屬性的描述,返回元組格式為 Item1:描述信息 Item2:屬性名稱
    /// </summary>
    /// <param name="type"></param>
    /// <returns></returns>
    public static Tuple<string, string>[] GetDescription(this BindableBase bindData)
    {
        var proAry = bindData.GetType().GetProperties();
        var desAry = new Tuple<string, string>[proAry.Length];
        string desStr;
        for (int i = 0; i < proAry.Length; i++)
        {
            var attrs = (DescriptionAttribute[])proAry[i].GetCustomAttributes(typeof(DescriptionAttribute), false);
            desStr = proAry[i].Name;
            foreach (DescriptionAttribute attr in attrs)
            {
                desStr = attr.Description;
            }
            desAry[i] = Tuple.Create(desStr, proAry[i].Name);
        }
        return desAry;
    }


    /// <summary>
    /// 載入同類型指定對象的屬性值,如果當前屬性值或目標屬性值為null則不執行賦值操作
    /// </summary>
    /// <param name="data"></param>
    public static void Load(this BindableBase source, BindableBase dest)
    {

        if (source == null || dest == null)
        {
            //不執行操作
            return;
        }
        Type type = source.GetType();
        if (type != dest.GetType())
        {
            throw new ArgumentNullException("參數類型不一致");
        }
        var proAry = type.GetProperties();
        for (int i = 0; i < proAry.Length; i++)
        {
            var proType = proAry[i].PropertyType;
           
            if (proType.IsSubclassOf(typeof(BindableBase)))
            {
                //檢測到內部嵌套的綁定基類,建議不處理直接跳過,這種情況應該單獨處理內嵌對象的數據載入
                //var childData = (BindableBase)(proAry[i].GetValue(source));
                //childData.Load((BindableBase)(proAry[i].GetValue(dest)));
            }
            else
            {
                proAry[i].SetValue(source, proAry[i].GetValue(dest));
            }
        }
    }
}

簡單控制項綁定

簡單屬性綁定是指某對象屬性值和某控制項屬性值之間的簡單綁定,需要瞭解以下內容:

使用方法如下:

 Data data = new Data() { ID=1,Name="test"};
//常規綁定方法        
textBox1.DataBindings.Add("Text", data, "ID");
//使用這種方式避免硬編碼
textBox2.DataBindings.Add("Text", data, nameof(data.Name));

註:這種綁定會自動處理字元串到數據的類型轉換,轉換失敗會自動恢複原值。

列表控制項綁定

列表控制項綁定主要用於 ListBoxComboBox 控制項,它們都屬於 ListControl 類的派生類。ListControl 類ListBox 類和 ComboBox 類提供一個共同的成員實現方法。

註:CheckedListBox 類派生於 ListBox 類,不再單獨說明。

使用列表控制項綁定前,需要瞭解以下內容:

  • ListControl.DataSource 屬性:獲取或設置此 ListControl 的數據源,值為實現 IListIListSource 介面的對象,如 DataSet 或 Array。

  • ListControl.DisplayMember 屬性:獲取或設置要為此 ListControl 顯示的屬性,指定 DataSource 屬性指定的集合中包含的對象屬性的名稱,預設值為空字元串("")。

  • ListControl.ValueMember 屬性:獲取或設置屬性的路徑,它將用作 ListControl 中的項的實際值,表示 DataSource 屬性值的單個屬性名稱,或解析為最終數據綁定對象的屬性名、單個屬性名或句點分隔的屬性名層次結構, 預設值為空字元串("")。

註:最終的選中值只能通過ListControl.SelectedValue 屬性獲取,目前還沒找到可以綁定到數據的方法。

綁定BindingList集合

BindingList是一個可用來創建雙向數據綁定機制的泛型集合,使用方法如下:

BindingList<Data> list = new BindingList<Data>();
list.Add(new Data() { ID = 1, Name = "name1" });
list.Add(new Data() { ID = 2, Name = "name2" });

comboBox1.DataSource = list;
comboBox1.ValueMember = "ID";
comboBox1.DisplayMember = "Name";

註:如果使用List泛型集合則不支持雙向綁定。同理,如果Data沒有繼承綁定基類,則屬性值的變更也不會實時更新到界面。

綁定DataTable表格

DataTable支持雙向綁定,使用方法如下:

DataTable dt = new DataTable();
DataColumn[] dcAry = new DataColumn[] 
{ 
    new DataColumn("ID"),
    new DataColumn("Name") 
};
dt.Columns.AddRange(dcAry);
dt.Rows.Add(1, "name1Dt");
dt.Rows.Add(2, "name2Dt");

comboBox1.DataSource = dt;
comboBox1.ValueMember = "ID";
comboBox1.DisplayMember = "Name";

綁定BindingSource源

BindingSource 類封裝窗體的數據源,旨在簡化將控制項綁定到基礎數據源的過程,詳細內容可查看 BindingSource 組件概述

有時候數據類型可能沒有實現INotifyPropertyChanged介面,並且這個數據類型我們還修改不了,這種情況就只能使用BindingSource來將控制項綁定到數據了。

假設Data類沒有繼承BindableBase,綁定方法如下:

List<Data> list = new List<Data>();            
list.Add(new Data() { ID = 1, Name = "name1" });
list.Add(new Data() { ID = 2, Name = "name2" });

BindingSource bs = new BindingSource();
bs.DataSource = list;
comboBox1.DataSource = bs;
comboBox1.ValueMember = "ID";
comboBox1.DisplayMember = "Name";

關鍵是下麵的步驟,改變集合內容時手動觸發變更:

//單項數據變更
list[0].Name = "test";
bs.ResetItem(0);

//添加數據項
list.Add(new Data() { ID = 3, Name = "name3" });
bs.ResetBindings(false);
//在BindingSource上添加或使用BindingList列表,則可以不用手動觸發變更通知
bs.Add(new Data() { ID = 4, Name = "name4" });

表格控制項綁定

綁定DataTable

方法如下:

DataColumn c1 = new DataColumn("ID", typeof(string));
DataColumn c2 = new DataColumn("名稱", typeof(string));
dt.Columns.Add(c1);
dt.Columns.Add(c2);
dt.Rows.Add(11, 22);

//禁止添加行,防止顯示空白行
dataGridView1.AllowUserToAddRows = false;
//選擇是否自動創建列
dataGridView1.AutoGenerateColumns = true;

dataGridView1.DataSource = dt.DefaultView;

綁定BindingList

方法如下:

//填充數據
 BindingList<Data> dataList = new BindingList<Data>();
 for (int i = 0; i < 5; i++)
 {
     dataList.Add(new Data() { ID = i, Name = "Name" + i.ToString() });
 }


 //禁止添加行,防止顯示空白行
 dataGridView1.AllowUserToAddRows = false;
 //選擇是否自動創建列
 dataGridView1.AutoGenerateColumns = false;
 //手動創建列
 var desAry = dataList[0].GetDescription();
 int idx = 0;
 foreach (var des in desAry)
 {
     idx = dataGridView1.Columns.Add($"column{idx}", des.Item1);     // 手動添加某列
     dataGridView1.Columns[idx].DataPropertyName = des.Item2;        // 設置為某列的欄位
 }
 //綁定集合
 dataGridView1.DataSource = dataList;
 //集合變更事件
 dataList.ListChanged += DataList_ListChanged;

註:上面的GetDescription()是綁定基類的擴展方法。

BindingList提供集合的變更通知,Data通過繼承綁定基類提供屬性值的變更通知。

UI線程全局類

上面所有綁定的數據源都不支持非UI線程的寫入,會引起不可預知的問題,運氣好的話也不會報異常出來。
為了方便多線程情況下更新數據源,設計一個UIThread類封裝UI線程SynchronizationContextPostSend的操作,用來處理所有的UI更新操作,關於SynchronizationContext可以參考SynchronizationContext 綜述

代碼如下:

/// <summary>
/// UI線程全局類
/// </summary>
public static class UIThread
{
    private static SynchronizationContext context;


    /// <summary>
    /// 同步更新UI控制項的屬性及綁定數據源
    /// </summary>
    /// <param name="act"></param>
    /// <param name="state"></param>
    public static void Send(Action<object> act, object state) 
    {
        context.Send(obj=> { act(obj); }, state);
    }

    /// <summary>
    /// 同步更新UI控制項的屬性及綁定數據源
    /// </summary>
    /// <param name="act"></param>
    public static void Send(Action act)
    {
        context.Send(obj => { act(); }, null);
    }

    /// <summary>
    /// 非同步更新UI控制項的屬性及綁定數據源
    /// </summary>
    /// <param name="act"></param>
    /// <param name="state"></param>
    public static void Post(Action<object> act, object state)
    {
        context.Post(obj => { act(obj); }, state);
    }

    /// <summary>
    /// 非同步更新UI控制項的屬性及綁定數據源
    /// </summary>
    /// <param name="act"></param>
    public static void Post(Action act)
    {
        context.Post(obj => { act(); }, null);
    }


    /// <summary>
    /// 在UI線程中初始化,只取第一次初始化時的同步上下文
    /// </summary>
    public static void Init()
    {
        if (context == null) 
        { 
            context = SynchronizationContext.Current; 
        }
    }
}

直接在主界面的構造函數裡面初始化即可:

UIThread.Init();

使用方法如下:

Task.Run(() => 
{
    //同步更新UI
    UIThread.Send(() => { dataList.RemoveAt(0); });
});

您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 哈夫曼編碼應用 問題描述 ​ 給定字元串,將每個不同的字元的哈夫曼編碼表示並輸出其哈夫曼編碼,並再將其哈夫曼編碼還原回字元串 分析一下 構建哈夫曼樹 ​ 使用靜態鏈表,先將所有的結點關係全部清零,再進行結點和相應權值的賦值,遍歷後n-1個結點 (新根),從n個結點中選兩個最小的權值了合成一棵樹,並將 ...
  • 一.小結 1.一個boolean變數可以存儲值true或false 2.關係運算符(<,<=,==,!=,>,>=)和數值及字元一起運算 3.布爾運算符&&,|| ,| 和 ^對布爾值和布爾變數進行計算 4.當對p1&&p2求值時,java先求p1的值,如果p1為true,再對p2求值;如果p1為f ...
  • 迭代器的功能: 提供一種統一的方式,來透明的遍歷容器 理解 begin()方法,end()方法, ++ , * 的用處 其中 C++11 中提供的foreach的方式,其底層還是通過迭代器來進行遍歷的. #include <iostream> using namespace std; class M ...
  • 1 概述 ArrayList實現了List介面,是 順序容器,允許放入null元素 有一個容量(capacity),表示底層數組的實際大小。如果容量不足,容器會 自動增大底層數組的大小 支持泛型,泛型擦除後,容器的元素都是 Object類型 ArrayList沒有實現同步(synchronized) ...
  • 來源:blog.csdn.net/weixin_61594803 1.SQL數據脫敏實現 MYSQL(電話號碼,身份證)數據脫敏的實現 -- CONCAT()、LEFT()和RIGHT()字元串函數組合使用,請看下麵具體實現 -- CONCAT(str1,str2,…):返回結果為連接參數產生的字元 ...
  • ###知識點 php://filter php://filter是一種元封裝器,是PHP中特有的協議流,設計用於數據流打開時的篩選過濾應用,作用是作為一個“中間流”來處理其他流。 php://filter目標使用以下的參數作為它路徑的一部分。複合過濾鏈能夠在一個路徑上指定。 |名稱|描述|備註| | ...
  • ###結果以json格式輸出,可以用json線上解析,方便查看 package com.xintone.demo; import cn.hutool.json.JSONUtil; import lombok.Data; import org.springframework.util.Collecti ...
  • 關於全局事務的執行,雖然之前的文章中也有所涉及,但不夠細緻,今天再深入的看一下事務的整個執行過程是怎樣的。 1. TransactionManager io.seata.core.model.TransactionManager是事務管理器,它定義了一個全局事務的相關操作 DefaultTransa ...
一周排行
    -Advertisement-
    Play Games
  • 簡介 本文的初衷是希望幫助那些有其它平臺視覺演算法開發經驗的人能快速轉入Halcon平臺下,通過文中的示例開發者能快速瞭解一個Halcon項目開發的基本步驟,讓開發者能把精力完全集中到演算法的開發上面。 首先,你需要安裝Halcon,HALCON 18.11.0.1的安裝包會放在文章末尾。安裝包分開發和 ...
  • 本文是對Datawhale的動手學數據分析課程的學習總結,記錄了整體的學習過程、答案以及個人感想,代碼較為詳細。 ...
  • JZ7重建二叉樹 描述 給定節點數為 n 的二叉樹的前序遍歷和中序遍歷結果,請重建出該二叉樹並返回它的頭結點。 例如輸入前序遍歷序列{1,2,4,7,3,5,6,8}和中序遍歷序列{4,7,2,1,5,3,8,6} 提示: 1.vin.length == pre.length 2.pre 和 vin ...
  • 我們都知道在Java編程中多線程的同步使用synchronized關鍵字來標識,那麼這個關鍵字在JVM底層到底是如何實現的呢。 我們先來思考一下如果我們自己實現的一個鎖該怎麼做呢: 首先肯定要有個標記記錄對象是否已經上鎖,執行同步代碼之前判斷這個標誌,如果對象已經上鎖線程就阻塞等待鎖的釋放。 其次要 ...
  • 目錄 一.OpenGL 色階 1.Windows OpenGL ES 版本 2.Windows OpenGL 版本 二.OpenGL 色階 GLSL Shader 三.猜你喜歡 零基礎 OpenGL ES 學習路線推薦 : OpenGL ES 學習目錄 >> OpenGL ES 基礎 零基礎 Ope ...
  • 1. 查看Linux伺服器版本信息 # cat /etc/redhat-release CentOS Linux release 7.4.1708 (Core) 2. 禪道開源版安裝包下載 wget http://dl.cnezsoft.com/zentao/9.8.2/ZenTaoPMS.9.8. ...
  • Spring 框架可以為 Java 應用程式開發提供全面的基礎設施支持,它是現在非常流行的 Java 開源框架,對於一個 Java 開發人員來說,熟練掌握 Spring 是必不可少的。 ...
  • 前言 本篇是c++總結的第二篇,關於c++的對象模型,在構造、拷貝虛函數上重點分析,也包含了c++11class的新用法和特性,如有不當,還請指教! c++三大特性 訪問許可權 ​ 在c++中通過public、protected、private三個關鍵字來控製成員變數和成員函數的訪問許可權,它們分別表示 ...
  • 一.小結 1.使用二維數組來存儲表格 2.可以使用以下語法來聲明二維數組變數: 元素類型[ ] [ ]數組變數 3.可以使用以下語法來創建二維數組變數: new 元素類型 [行的個數][列的個數] 4.使用下麵的語法表示二維數組中的每個元素: 數組變數[行下標][列的個數] 5.可使用數組初始化語法 ...
  • typimg是一款為typora編輯器提供圖像自定義上傳服務的工具,該工具將在typora中輸入的網路圖片、本地圖片、剪貼板圖片/截圖上傳到博客園,支持在MacOS、Windiws、Linux三個平臺上運行。 ...