【功能說明】
用途：使用於Client端，繼承自BindingSource元件，與InfoDataSet或者CacheDataSet配合使用。用於建立各UI資料元件與InfoDataSet資料表間的連接，並透過本元件來進行對InfoDataSet的各種資料操作。
【元件屬性】
Name(名稱)(string)
元件名稱，用於識別該元件。
AutoApply(自動存檔)(bool)
設為True時，在執行EndEdit()單筆確認功能時，會讓InfoDataSet自動執行ApplyUpdate()的動作，也就是每編輯一筆BindingSource的資料並確認後，即要自動讓InfoDataSet存檔到Server端一次，此目的是為了能更即時將U/I的資料存檔到資料庫中。如配合InfoNavigator元件時，按下Ok按鈕時，就會直接將資料儲存到後端資料庫中，如果設為False，則需要按下Apply才會執行資料的儲存。一般在InfoDataSet有Master/Detail的情況下，對Master一般都是設為True的，但如果是Detail則都是設為False。
AutoApplyMaster(自動表頭存檔)(bool)
此專門應該在Master/Detail的架構上,當新增Master後，並在輸入Detail前是否要先將Master進行Apply存檔，此應用在Master的主鍵為自增值欄位(每次自動加一)，所以要配合
AutoApplyMaster=True來強迫Master存檔並取回鍵值後，才能正確對Detail輸入資料。
AutoDisableControl(自動失能控制)(bool)
True/False，可依據當前資料的編輯狀態，自動控制到連接此BindingSource各UI資料元件的致能與失能狀態。為True代表一般情況下，各UI資料元件是處於失能的狀態下，就是不能讓User編輯；除非配合InfoNavigator的Edit功能或執行BeginEdit()方法，才會讓各UI資料元件進入致能狀態讓User編輯。如設為False，系統將不會對各UI資料元件做任何致能與失能的控制。
AutoDisableStyle(自動失能控制樣式)(Srvtools.InfoBindingSource.AutoDisableStyleType)
自動失能控制樣式，有Enable和ReadOnly兩種。
CloseProtect(關閉保護)(bool)
用來保護資料在編輯狀態下防止使用者關閉視窗，當設為True時，如果對應到本InfoBindingSource的資料有被異動且尚未存檔到後端時，則會提示給User並禁止關閉視窗，為False則不保護此行為。
DataMember(資料成員)(string)
對應的資料表名稱，此可以對應到一個DataSet資料集中的某一個Table (因為一個DataSet會有多個Table的內容)；本屬性要搭配DataSource共同使用，不能單獨使用。
DataSource(資料源)(DataSource)
對應的資料集，一般對象是DataSet，與DataMember配搭使用，當DataSource指向DataSet時，則DataMember就必須設定指向其DataSet內的某一個Table；但是如果DataSet有Master/Detail的關聯關係時，Master可按上述的方式設定，DataSource指向DataSet，DataMember指向DataSet內的Master Table，但Detail則就不一樣了，DataSource必須指向Master的InfoBindingSource，而非原來的DataSet，DataMember則改指向Master的InfoBindingSource內的Relation1關連表(系統自動建立的關連資料表)。
DelayInterval(延遲時間)(int32)
這個屬性專門給RelationDelay所使用，系統預設是300毫秒，也就是0.3秒，用途請參考RelationDelay。
DisableKeyFields(隱藏主鍵欄位)(bool)
隱藏主鍵欄位。
FocusedControl(焦點元件)
設定在新增或編輯時，進入焦點的Control。
RelationDelay(關聯延遲)(bool)
本屬性是專門給Relations 動態關連所使用，設定是否開啟關聯延遲。因為Relations會在User移動資料時，對另外的DataSet請求顯示相對資料，因Relations是動態取資料，因此會引發對方的DataSet向後端請求資料下載，所以當User在原始的InfoBindingSource的DataGridView中快速移動資料時，將會引發DataSet過多的資料下載，使用RelationDelay可以延遲DataSet對A/P Server請求資料的時間，延遲時間則在DelayInterval定義之，也就是每User移動一筆，除非停留DelayInterval的時間，否則對方的DataSet不會去下載資料，如此將可以大幅加速User對DataGridView操作的反應時間，增加系統的效能。
Relations(關聯明細)(Collection)
設定本InfoBindingSource與其他DataSet的關聯關係。可以定義與多個DataSet的關係，每個Relation的屬性說明如下：
RelationDataSet(關聯的資料集)(DataSet)：所要關聯的資料集，當InfoBindingSource每移動一筆資料時，都會引發此DataSet重新下載一次資料。
SourceKeyFields(來源關聯主鍵)(string)：設定本InfoBindingSource要與其他DataSet去關聯時的主鍵，可設定多個欄位。
TargetKeyFields(目的關聯主鍵)(string)：設定對方DataSet
的關聯主鍵，也可設定多個欄位，但應與SourceKeyFields
裡設定的欄位數量相同，保持一對一的對應，並且依次序對
應。
Active(啟用)(bool)：是否開啟Relation，可以利用此屬性暫時關閉關連關係。
AllowAdd(允許新增) (bool)
是否允許此BindingSource新增資料，用來配合InfoSecurity的功能，控制那些群組可以有權限使用這些功能。
AllowDelete(允許刪除) (bool)
是否允許此BindingSource刪除資料，用來配合InfoSecurity的功能，控制那些群組可以有權限使用這些功能。
AllowUpdate(允許更改) (bool)
是否允許此BindingSource更改資料，用來配合InfoSecurity的功能，控制那些群組可以有權限使用這些功能。
AllowPrint (允許印表) (bool)
是否允許此BindingSource列印資料(指InfoNaivagor的「Print」的Buttons是否可以執行)，用來配合InfoSecurity的功能，控制那些群組可以有權限使用這些功能。
【事件】
AddingNew(新增前)
在新增時觸發。
AfterDelete(刪除後)
在刪除以後觸發。
AfterEdit(編輯後)
在編輯完成後觸發。
BeforeEdit(編輯前)
在編輯時觸發。
BindingComplete(綁定後)
在與DataSet進行完資料的綁定之後時觸發。
CurrentChanged(當前值改變後)
在當前一筆的值改變後觸發。
CurrentItemChanged(當前項改變後)
在當前項的屬性值改變後觸發。
ListChanged()(資料移動後)
在資料有移動後時觸發。
PositionChanged()(資料移動後)
在資料有移動後時觸發。
AllowProperyChanged(當InfoBindingSource中的所有Allow類屬性變化後)
在InfoBindingSource的AllowAdd,AllowUpdate,AllowDelete以及AllowPrint的屬性值有變化時觸發
【功能函數】
AddNew()
對目前InfoBindingSource所對應的資料進行新增的動作。
BeginEdit()
對目前筆資料進行編輯的動作。
EndEdit()
對目前筆資料進行編輯確認的動作，如果AutoApply=True時，此功能會讓DataSet引發Apply的動作。
CancelEdit()
對目前筆資料取消編輯的動作。
MoveFirst()
讓資料移動到首筆。
MoveLast()
讓資料移動到末筆。
MoveNext()
讓資料移動到下筆。
MovePrevious()
讓資料移動到上筆。
RemoveCurrent()
對目前筆資料進行刪除的動作。
Refresh()
讓對應的DataSet重新到Server上讀取最新的資料下來。並能重新定位到原來那一筆資料。
ResumeBinding()
對DataSet重新進行資料綁定的動作。
SuspendBinding()
對DataSet進行取消資料綁定的動作。
【其他說明】
其實在設計資料編輯時，各UI資料編輯元件可透過InfoDataSet直接與Table相互綁定，但在EEP中不建議這樣使用，而必須透過InfoBindingSource與InfoDataSet連接使用，這是因為EEP的很多U/I元件都是以InfoBindingSource為基礎做一些基本控制，尤其是RefVal與InfoNavigator等元件更是與InfoBindingSource息息相關，因此在開發上須密切的配合。
【範例】
以下是從InfoBindingSource中取欄位值的方法：
ibsDetail.MoveFirst();
while (ibsDetail.Position+1<= ibsDetail.Count) // 沒有eof的旗幟，所以要使用Count來判斷
DataRowView dr = (DataRowView)ibsDetail.Current;
MessageBox.Show(dr.Row["ProductID"].ToString());
int oldPos = ibsDetail.Position;
ibsDetail.MoveNext();
if (ibsDetail.Position == oldPos) break; // Position一樣代表沒有資料了
}
以下是從InfoBindingSource中自行新增資料的方法：
ibsDetail.AddNew(); //新增
DataRowView dr = (DataRowView)ibsDetail.Current; //取出DataRow Object，對DataRow進行處理
dr.Row["ProductID"] = 12;
dr.Row["Quantity"] = 10;
dr.Row["UnitPrice"] = 10;
dr.Row["Discount"] = 1;
ibsDetail.EndEdit(); // 確定欄位的設值
以下是從InfoBindingSource中自行刪除資料的方法：
{
//ibsDetail.RemoveAt(ibsDetail.Position); //這樣寫也可以.
ibsDetail.RemoveCurrent();
}
| Converted from CHM to HTML with chm2web Pro 2.85 (unicode) |