BindingSource

基於BindingSource的WinForm開發

 

 

1.引言

BindingSource組件是數據源和控件間的一座橋,同時提供了大量的API和Event供我們使用。使用這些API我們可以將Code與各種具體類型數據源進行解耦；使用這些Event我們可以洞察數據的變化。

2.簡單綁定

DataTable myTable = myTableAdapter.GetData();//創建Table

BindingSource myBindingSource= new BindingSource();//創建BindingSource

DataGridView myGrid = new DataGridView();//創建GridView

myGrid.DataSource = myBindingSource；//將BindingSource綁定到GridView

myTable;//綁定數據到BindingSource

注：

1）綁定到DataTable，其實是綁定到DataTable提供的DataView上。每個DataTable都有一個缺省的DataView

2）DataView是綁定的實質，正如其名，它是DataTable的數據的展現。因此可以對同一個DataTable

，構建多個DataView,進而可以對這同樣的數據實施不同的過濾、排序等方法，從不同側面展示DataTable。這也體現了一定的MVC思想。

3）BindingSouce也可作爲數據（其實是數據引用）的容器在不同窗體間傳遞，從而實現在彈出窗體中對數據的編輯

3.主細表

以上圖所示數據爲例：

1）DataSet：myDataSet

2）DataTable：ParentTable、ChildTable、GrandChildTable

3）Relation：FK_Parent_Child、FK_Child_GrandChild

//綁定父數據

parentBindingSource.DataSource = myDataSet;

parentBindingSource.DataMember = "ParentTable";

m_GrandParentGrid.DataSource = m_GrandParentBindingSource;

//綁定子數據。
childBindingSource.DataSource = parentBindingSource;//綁定到“父BindingSource”，而不是父Table

childBindingSource.DataMember = "FK_Child_GrandChild";//綁定到“父－子Relation”

//綁定孫子數據。
grandChildBindingSource.DataSource = childBindingSource;//綁定到“子BindingSource”

grandChildBindingSource.DataMember = "FK_Child_GrandChild";//綁定到“子－孫Relation”

這樣你就可以在Form上擺上3個DataView，分佈綁定到這3個BindingSouce，很容易就實現了主細表關聯展現。

4.數據操縱

要操縱數據，首先需要獲取當前數據項。BindingSource的Current屬性返回DataRowView類型的對象（就像DataView是對DataTable的封裝一樣，DataRowView是對DataRow的封裝），它是對當前數據項的封裝，可以通過類型轉換變成你想要的對象。

DataRowView currentRowView = myBindingSource.Current；//獲取當前RowView

CustomersRow custRow = currentRowView.Row as CustomersRow;//類型轉換爲當前數據項

string company = custRow.CompanyName;//使用當前數據項

string phoneNo = custRow.Phone;

5.用BindingSource做數據容器

BindingSource還可以用作數據容器，即便它沒有綁定到數據源上，它內部有一個可以容納數據的list。

5.1Add方法

調用Add方法會在BindingSource的list中插入數據項。如果這時第一次插入數據，並且沒有綁定數據，那麼插入數據的類型就決定了今後此list中數據的類型。

注：

1）此時再插入其它類型對象會拋出InvalidOperationException異常

2）設置DataSource屬性時會刷新list，造成Add方法添加到list中的數據丟失

5.2AddNew方法

AddNew方法返回BindingSourc所容納數據類型的對象；如果之前沒有容納數據，則會返回Object對象。

AddNew方法會調用EndEdit方法，並將提交對當前數據的操縱；然後新數據項就成爲當前項。

AddNew方法會引發AddingNew事件，可以在此事件中爲數據項賦值，或者創建新數據項

private void OnAddingNew(object sender, AddingNewEventArgs e)
{
      e.NewObject = new MyCustomObject();//
}

6.用BindingSource對數據排序、過濾、搜索

6.1 Sort

爲Sort屬性賦上Sort表達式，可以對數據進行排序

myBindingSource.Sort = "ContactName ASC";//對ContanctName列按ASC進行排序

myBindingSource.Sort = "Region ASC, CompanyName DESC"//先按Region、再按CompanyName排序

6.2 Find

Find方法根據指定屬性和關鍵字進行查找，並返回第一個匹配對象的Index
int index = m_CustomersBindingSource.Find("CompanyName",IBM);//按CompanyName查找IBM
if (index != -1)
{
    myBindingSource.Position = index;//定位BindingSource
}

6.3 Filter

爲Filter屬性賦上表達式，可以對數據進行過濾

m_CustomersBindingSource.Filter = "Country = 'Germany'";//過濾出Country屬性爲Germany的數據

7.用Event監控數據

7.1 Event

1）AddingNew

調用AddNew（）方法時觸發。

2）BindingComplete

當控件完成數據綁定時觸發，說明控件已經從數據源中讀取當前數據項的值。當BindingSource重新綁定或當前數據項改變時，會觸發此事件

注：

• 當有多個控件綁定到同一數據源時，這個事件會觸發多次

3）CurrrentChanged

當前數據項改變時觸發此事件。觸發此事件的情況如下

• Position屬性改變時
• 添加、刪除數據時
• DataSource或DataMember屬性改變時

4）CurrentItemChanged

當前數據項的值改變時觸發

5）DataError

通常輸入無效數據時，由CurrencyManage拋出異常，從而觸發此事件。

6）PositionChanged

Position屬性改變時觸發此事件。

7）ListChanged

數據集合改變時觸發。觸發此事件的情況如下

• adding, editing, deleting, 或 moving 數據項時

改變那些會影響List行爲特徵的屬性時，如AllowEdit屬性

• 替換List時（綁到新數據源）

8.限制數據修改

BindingSource不僅是數據源與控件間的“橋樑”，同時也是數據源的“看門人”。通過BindingSource，我們可以控制對數據的修改。

BinidingSource的AllowEdit, AllowNew和AllowRemove屬性可以控制客戶端代碼和控件對數據的修改

9.複雜數據類型的Binding

對於String類型的數據，直接Binding到Text控件即可，對於複雜類型有下面幾種情況

• 對於DateTime、Image等類型的數據，它們存儲的格式與顯示要求並不一致。
• 有時，你並不想顯示客戶ID，而是希望顯示客戶名稱
• 數據庫中的Null值

9.1 Binding類

解決以上問題的關鍵是要理解Binding類，瞭解它是如何控制數據Binding的過程。

DataTable table = customersDataSet.Customers;

//將TextBox的Text屬性Binding到table的CustomerID列
customerIDTextBox.DataBindings.Add("Text", table,"CustomerID", true);

//上面一行代碼等同下面兩行代碼

Binding customerIDBinding = new Binding("Text", table,"CustomerID", true);
customerIDTextBox.DataBindings.Add(customerIDBinding);

從代碼可以看出，Binding是數據源(table)和控件(customerIDTextBox)間的中介人，它有以下功能

• 從數據源取數據，並按照控件要求的數據類型對此數據進行格式化（Formatting），然後傳給控件
• 從控件取數據，並按照數據源的數據類型要求對此數據進行解析（Parsing），然後返回給數據源
• 自動對數據進行格式轉換

9.2Binding類構造函數和屬性

Binding構造函數有多個重載版本，下面介紹其重要的參數，這些參數同時存在於Binding對象的屬性中。下面介紹中，參數名和屬性名都列出來

1）formattingEnabled（屬性FormattingEnabled）

•  
  • true，Binding對象自動在數據源類型和控件要求的類型間進行轉換
  • false，反之

2）dataSourceUpdateMode

決定控件上數值的改變在何時提交回數據源

3）nullValue

DBNull、 null和Nullab<T>對應的值。

4）formatString

格式轉換

5）formatInfo

一個實現IFormatProvider接口的對象引用，用來自定義格式轉換

要了解類型如何轉換的，請學習Type Conversions and Format Providers相關內容。關於上面屬性的應用，請看下面介紹

9.3基於Binding類的內置機制（屬性、參數）進行類型轉換

通過Binding類構造時的參數，或屬性設置，可以控制它進行類型轉換的機制。

1）DateTime

下面先介紹一個DateTime類型的例子，使用DateTimePicker控件

//創建Binding，設置formattingEnabled爲true

birthDateTimePicker.DataBindings.Add("Value",m_EmployeesBindingSource, "BirthDate", true);

//設定爲使用自定義格式
birthDateTimePicker.Format = DateTimePickerFormat.Custom;

//設定格式
birthDateTimePicker.CustomFormat = "MM/dd/yyyy";

2）Numeric

salaryTextBox.DataBindings.Add("Text", employeesBindingSource,"Salary", true,  DataSourceUpdateMode.OnValidation,"<not specified>", "#.00");

以上代碼做了以下處理

• 設定formattingEnabled爲true:代表自動類型轉換
• 設定DataSourceUpdateMode爲OnValidation：
• 設定nullValue爲"<not specified>"：這些DBNull就顯示爲,"<not specified>", 同時用戶錄入,"<not specified>"時，數據值爲DBNull
• 設定formatString爲"#.00"：數值保留2位小數

9.4. 事件

下面介紹Binding的主要事件，以及如何基於這些事件進行類型轉換的控制。

主要事件：

1）Format事件

發生在從數據源獲取數據後，控件顯示此數據之前。在這個事件裏將數據源的數據類型轉換爲控件要求的數據類型。

2）Parse事件

與Event相反。它發生控件值改變後，數據更新回數據源之前。在這個事件裏將控件的數據類型轉換爲數據源要求的數據類型。

這兩個事件爲我們控制數據提供了機制，它們都聲明爲ConvertEventHandler類型，

void ConvertEventHandler(object sender, ConvertEventArgs e);

有兩個參數，第二個參數ConvertEventArgs e 提供了我們要formatting和parsing的數據。它有兩個屬性

• e.DesiredType是數值要轉換的目標類型
• e.Value是要轉換的數值。我們可以替換此Value

9.5. 基於事件的類型轉換

9.5.1 處理Format Event

void OnCountryFromFormat(object sender, ConvertEventArgs e)
{
    if (e.Value == null || e.Value == DBNull.Value)
    {
         pictureBox.Image = null;
         return;
    }

    //綁定的是數據源的CountryID字段，因此e.Value返回的ID號，通過此ID號取得對應數據行
    CountriesRow countryRow =    GetCountryRow((int)e.Value);

     //將e.Value賦值爲CountryName,從而在控件中顯示名稱
     e.Value = countryRow.CountryName;
    // 數據轉換

    ImageConverter converter = new ImageConverter();
    pictureBox.Image =    converter.ConvertFrom(countryRow.Flag) as Image;
}

9.5.2 處理Format Event

void OnCountryFromParse(object sender, ConvertEventArgs e)
{
// Need to look up the Country information for the country name
ExchangeRatesDataSet.CountriesRow row =
GetCountryRow(e.Value.ToString());
if (row == null)
{
string error = "Country not found";
m_ErrorProvider.SetError(m_CountryFromTextBox, error);
m_CountryFromTextBox.Focus();
throw new ArgumentException(error);
}
e.Value = row.CountryID;
}

10 完成數據編輯

經常會遇到這種情況，你在一個控件中錄入或選擇一些數據，只有當年離開此控件時，關聯的數據才能同步更新。這個問題是由DataRow內部機制決定的。

DataRowView類實現IEditableObject接口，支持對象的事務性編輯（當你確認完成編輯前，可以回滾數據）。我們通過BeginEdit（）方法來開始數據編輯，通過EndEdit（）方法提交編輯。

不要將DataRowView的EndEdit（）與DataSet、DataTable、DataRow的AcceptChanges（）方法混淆。DataRow有original和current版本，同時IEditableObject的caching機制讓它有transient版本，在調用EndEdit（）方法前，數據修改是不會提交到數據源。這就是前面問題的內在原因。

如果希望編輯的數據立即提交，那調用EndEdit（）函數的最佳位置就是Validated事件。Validate事件在控件錄入的數據parsed，並且通過validate後觸發，在這個事件中觸發EndEdit（）就會通知綁定到同一數據源的所有控件，從而實現數據同步更新。

private void OnCountryTextValidated(object sender, EventArgs e)
{
          exchangeRatesBindingSource.EndEdit();
}

當然，當前數據項改變時，也會觸發EndEdit（）事件

11 使用AutoComplete

當你希望TexbBox或ComboBox中會自動提示功能，那你應該學習一下AutoComplete功能。下面以TextBox爲例介紹相關步驟

1）設定TextBox的AutoCompleteSource屬性：FileSystem, HistoryList, RecentlyUsedList

2）如果希望使用自定義的列表，則設定AutoCompleteSource屬性爲CustomSource

3）設定AutoCompleteMode爲SuggestAppend。這意味着你輸入部分字符時，控件在下拉列表中提示所有相近的數據

4）如果不想使用內置的提示源，你可以自己創建一個AutoCompleteStringCollection類的列表，

5）創建這個列表後，將它賦給TextBox的AutoCompleteCustomSourc屬性

12 DataBinding的生命週期

BindingSource的DataSourceUpdateMode屬性是關鍵，它有以下三種可能值，下面分佈以TextBox控件爲例介紹此屬性不同時DataBinding的生命週期

1）OnValidating（缺省值）

• DataBinding的生命週期：

TextBox.Leave, TextBox.Validating, Binding.Parse, TextBox.Validated

• 此時若將控件的CausesValidation屬性設爲false，那麼Validating事件就不會發生

2）OnPropertyChanged

• DataBinding的生命週期：

此時,每次控件值發生改變時都會觸發Binding.Parse。對TextBox控件來說，每次錄入字符都會觸發Binding.Parse。

3）Never

此時Parse事件不會觸發，也就是說控件將成爲只讀的。

13 子父綁定

前面介紹了主細綁定，它其實是一個父子綁定。有時我們希望由子到父的關聯綁定，下面我們就一起來實現這個機制。實現這個機制的關鍵還是Event，這個Event就是BindingSource的CurrentChanged事件

private void OnCurrentChanged(object sender, EventArgs e)
      {
         // 獲取當前的子DataRow
         ExchangeRatesDataSet.ExchangeRatesRow currentRow =
            (ExchangeRatesDataSet.ExchangeRatesRow)
            ((DataRowView)m_ExchangeRatesBindingSource.Current).Row;

         // 獲取關聯的父DataRow
         ExchangeRatesDataSet.CountriesRow fromCountryRow =
            currentRow.CountriesRowByFK_ExchangeRates_CountriesFrom;
         ExchangeRatesDataSet.CountriesRow toCountryRow =
            currentRow.CountriesRowByFK_ExchangeRates_CountriesTo;

         //顯示父DataRow的信息

         if (fromCountryRow != null && toCountryRow != null)
         {
            m_FromCountryCombo.SelectedValue = fromCountryRow.CountryID;
            m_ToCountryCombo.SelectedValue = toCountryRow.CountryID;
         }

}

14 綁定到數據的多個複本

有時，我們希望以不同角度看到同一數據，這時需要綁定到同一數據的多個複本。這裏的關鍵是CurrencyManager類，每個BindingSource管理着一個CurrencyManager。如果多個控件綁定到同一個BindingSource，那麼只有一個CurrencyManager，因此也就只有一個CurrentItem，這樣就造成這些綁定到同一BindingSource的控件同步刷新。要解決這個問題，我們需要多個CurrencyManager，也就是說我們可以創建多個BindingSource，且綁定到同一個數據源。

 

 

9.5 處理Null類型

這裏有兩個概念要弄清楚，.Net內置的Null類型與代表數據庫中的Null類型，以及它們的區別。

1）.Net內置的Null類型

• Nullable,引用類型
• Nuallable<T>，值類型

2）.Net用來代表數據庫中的Null類型

• DBNull，它有一個屬性Value，可以用來判斷數據是否爲DBNull

          if (northwindDataSet.Employees[0].Country == DBNull.Value)
         {
                 // Handle null case here
          }

         對強類型數據集

if (northwindDataSet.Employees[0].IsCountryNull())
{
// Handle null case here
}

•  

1）AddNew（）函數：用來添加一條數據，返回類型由綁定的DataSource決定。

1）綁定到DataSet/DataTable時，返回DataRowView對象。

注意：

      a）返回的不是DataSet或DataTable或DataRow。

      b）如果希望獲取添加的數據，需要進行類型轉換

           //bs爲你創建的BindingSource

          DataRow row=(DataRow)((DataRowView) bs.AddNew()).Row;

       c）使用TypedDataSet時，轉換方法與上面類似，只是用TypedDataRow而已

         //MyDataRow爲你定義的TypedDataRow

          MyDataRow row=(MyDataRow)((DataRowView) bs.AddNew()).Row;