【功能說明】

用途：此元件用於Client端，繼承自DataSet元件，用來配合Server端的InfoCommand相互連接，使得Client端可以透過對應的InfoCommand的SQL命令取得DatabaseServer的資料，並實現對資料的各種操作。

【元件屬性】

Name(名稱)(string)

元件名稱，用於識別該元件。

Active(啟動)(bool)

設定當前的InfoDataSet是否要開啟，設定為True時，系統會從Server上的InfoCommand元件中下載資料到此元件中。此屬性可在設計模式中設定預設True或False來控制開啟表單時是否要啟動此InfoDataSet。

AlwaysClose(開啟模式)(bool)

用來控制在此元件被啟動時是否要去下載資料，True代表不會去下載(會使用Where 1=0的方式將資料表打開但沒有資料)，False則會下載資料到此資料表中。

DataCompressed(資料壓縮)(bool)

用來控制是否要壓縮InfoDataSet的資料。

PackedRecords(傳送記錄數)(int32)

代表每次下載的資料筆數，當InfoDataSet要向InfoCommand取得資料時，每次要DownLoad多少比資料，都是由此屬性來決定，預設為100，代表每次下載一百筆；若為 -1，代表要將全部資料下載。除了資料在千筆以下，否則盡量調整本值在數百筆以內，好讓系統的效能可以增加。PackedRecord在資料移出範圍時，系統會自動再從InfoCommand上重抓下一個範圍資料，此屬性須配合InfoCommand的KeyFields才能抓取區塊範圍的資料。

RemoteName(遠程InfoCommand)(string)

在A/P Server上，每個InfoDataModule都可以有多個遠程資料表(InfoCommand)，透過InfoCommand可以向Database取得資料，在將資料存放在本元件的Table元件中，以提供Client各元件的資料存取服務。RemoteName的格式是 DLL.CommandName，前者是dll的模組名稱，後者則是InfoCommand的名稱。設計模式時可以在此選擇DataModule名稱(DLL)與所對應的InfoCommand名稱。

ServerModify(隨伺服端更新)(bool)

此屬性是設定如果Server端在Insert/Update後，如果後端的資料庫有發生其他的異動(如Stored Procedure或Trigger引發的資料異動或定序自增值的欄位等)，此時Client的資料則不是最新的，透過此屬性就可以將最新的資料傳回Client端，但此屬性必須配合UpdateComp.ServerModify也要設定為True才會有效。

【事件】

DataFilled(Eventarg e)

在取得的 InfoCommand 的資料後，會觸發該事件。

BeforeApplyUpdates(Eventarg e)

在 ApplyUpdate之前會被觸發。

AfterApplyUpdates(Eventarg e)

在 ApplyUpdate 成功時會被觸發。

ApplyError(Eventarg e)

此事件可以用來自行處理 Apply 的錯誤訊息，如可以在Server 端的 UpdateComp 中，利用　throw 拋出自定的 Error Message ，再讓 ApplyError 接收， 如下：

   private void ucOrderDetails_BeforeModify(object sender, UpdateComponentBefore ModifyEventArgs e)

 {

   // 檢查條件 , 當 Quantity<=0 時 , 要告之 User

   if (Convert.ToDecimal(ucOrderDetails.GetFieldCurrentValue("Quantity")) <= 0)

    {

       throw new Exception("StockNotEnough"); // 拋出自定訊息

       return;

    }

 }

在 InfoDataSet 的 ApplyError 中，去讀取 Server 端的自定訊息：

 private void idOrders_ApplyError(object sender, ApplyErrorEventArgs e)

 {

   // 檢查是否為自定訊息

   if (e.Exception.InnerException.Message == "StockNotEnough")

    {

       MessageBox.Show("Stock Not Enough!");  // 自行處理

       e.Cancel = true;  // 讓系統知道後端有錯誤

     }

  }

NextPacket(object sender, PacketEventArgs e)

此事件會在取得 Packet 所設筆數前後各處發一次 , 可以用 e.State 為 Before 或 After 來辨識是NextPacket 之前還是之後。

【功能函數】

First()

移動到第一筆。

Next()

移動到下一筆。

Prior()

移動到前一筆。

Last()

移動到最後一筆。

IsInserted(TableName)

用來判斷DataSet中指定的Table是否已經有Insert發生。

IsUpdated(TableName)

用來判斷DataSet中指定的Table是否已經有Update發生。

IsDeleted(TableName)

用來判斷DataSet中指定的Table是否已經有Delete發生。

bool  ApplyUpdates()

將Client端的資料存檔到後端的UpdateComp元件中。

bool  SetWhere(string WhereText)

重新設定InfoCommand的SQL Where語句，到Server端重新取得資料。WhereText代表Where的語法，會自動與Server上的InfoCommand結合。

例如：InfoDataSet1.SetWhere（”CUST_NO LIKE C%”）

DataSet Excute(string SQLText)

重新下SQL語句到Server端取得資料，SQLText為你重新所下達的SQL語法，其傳回值為一個DataSet，可以利用此DataSet來存放資料。

例如：

DataSet tmp;

Tmp=InfoDataSet1.Excute（”SELECT * FROM CUSTOMER”）;

Int max_ar=0;

for (int i = 0; i < Tmp.Tables[0].Rows.Count; i++)

  {  int aramt=Convert.ToInt32(Tmp.Tables[0].Rows[0][‘AR_AMT’]);

if (aramt>max_ar)  max_ar=aramt;

   }

return max_ar;

Int  GetRecordsCount(string where)

取得 DataSet 主 Table 的資料總筆數，如果有設 Where 代表某個 Where 條件，不指定代表整個 Table 。

ReadFromTxt(int tableIndex, string txtFileName)

用來提供外部讀取 Txt 文件， TableIndex 代表 DataSource 中 Table 的索引， txtFileName 代表為 Txt 文字檔格式的文件所在路徑，其中 txt 文件内容中欄位間是以 "," 或 "TAB" 為間格符號 , 資料是以 "LF" 換行作為資料格式。 如果遇到整行為空白資料，則會被過濾不被新增進 InfoDataSet 中。

ReadFromTxt(string TableName, string txtFileName)

用來提供外部讀取 Txt 文件， TableName 代表為 InfoDataSet 的 TableName 名稱， txtFileName 代表為 Txt 文字檔格式的文件所在路徑，其中 txt 文件内容中欄位間是以 "," 或 "TAB" 為間格符號 , 資料是以 "LF" 換行作為資料格式。 如果遇到整行為空白資料，則會被過濾不被新增進 InfoDataSet 中。

ReadFromXls(int tableIndex, string xlsFileName)

用來提供外部讀取 Excel 文件， TableIndex 代表 DataSource 中 Table 的索引， xlsFileName 代表為 xls 文字檔格式的文件所在路徑。 如果遇到整行為空白資料，則會被過濾不被新增進InfoDataSet 中。

public void ReadFromXls(int tableIndex, string xlsFileName, int beginrow, int begincell)

用來提供外部讀取 Excel 文件， TableIndex 代表 DataSource 中 Table 的索引， xlsFileName 代表為 xls 文字檔格式的文件所在路徑， BeginRow 表示 讀入的起始 Row 號， BeginCol 表示讀入的起始 Col 號 . 。如果遇到整行為空白資料，則會被過濾不被新增進 InfoDataSet 中。

ReadFromXls(string tableName, string xlsFileName)

用來提供外部讀取 Excel 文件， TableName 代表為 InfoDataSet 的 TableName 名稱， xlsFileName 代表為 xls 文字檔格式的文件所在路徑。 如果遇到整行為空白資料，則會被過濾不被新增進InfoDataSet 中。

ReadFromXls(string tableName, string xlsFileName, int beginrow, int begincell)

用來提供外部讀取 Excel 文件， TableName 代表為 InfoDataSet 的 TableName 名稱， xlsFileName 代表為 xls 文字檔格式的文件所在路徑， BeginRow 表示 讀入的起始 Row 號， BeginCol 表示讀入的起始 Col 號 . 。如果遇到整行為空白資料，則會被過濾不被新增進 InfoDataSet 中。

SetOrder(string strOrder)

在前端對資料排序， strOrder 代表排序欄位及方法。例如 : InfoDataSet.SetOrder("ID Desc"); // 以 ID 來排序 , Desc 為降冪排序

ToExcel( inttableIndex, stringxLSFileName)

用來輸出 InfoDataSet 的資料到Excel 中， TableIndex 代表 所要輸出的 Table 名稱的索引，XLSFileName 可以包函 Path 。

ToExcel( int tableIndex, string xLSFileName, string Title)

用來輸出 InfoDataSet 的資料到Excel 中， TableIndex 代表 所要輸出的 Table 名稱的索引，XLSFileName 可以包函 Path ， Title 代表輸出的 Excel 的文件内容的標題 。

ToExcel( int tableIndex, string xLSFileName, string Title, string Filter)

用來輸出 InfoDataSet 的資料到Excel 中， TableIndex 代表 所要輸出的 Table 名稱的索引，XLSFileName 可以包函 Path ， Title 代表輸出的 Excel 的文件内容的標題，Filter 則代表 Filter 再次過濾資料條件。

ToExcel(int tableIndex, string xLSFileName, string Title, string Filter, string Sort)

用來輸出 InfoDataSet 的資料到Excel 中， TableIndex 代表 所要輸出的 Table 名稱的索引，XLSFileName 可以包函 Path ， Title 代表輸出的 Excel 的文件内容的標題，Filter 則代表 Filter 再 次過濾資料條件 ， Sort 代表輸出資料的排序方式 。

ToExcel(int tableIndex, string xLSFileName, string Title, string Filter, string Sort, List< string>  IgnoreColumns)

用來輸出 InfoDataSet 的資料到Excel 中， TableIndex 代表 所要輸出的 Table 名稱的索引，XLSFileName 可以包函 Path ， Title 代表輸出的 Excel 的文件内容的標題，Filter 則代表 Filter 再 次過濾資料條件 ， Sort 代表輸出資料的排序方式，IgnoreColumns 代表不用輸出到 Excel 的欄位名稱 。

ToExcel( string tableName, string xLSFileName)

用來輸出 InfoDataSet 的資料到Excel 中 ， TableName 代表為 InfoDataSet 的 TableName 名稱， XLSFileName 可以包函 Path 。

ToExcel( string tableName, string xLSFileName, string Title)

用來輸出 InfoDataSet 的資料到Excel 中 ， TableName 代表為 InfoDataSet 的 TableName 名稱， XLSFileName 可以包函 Path ， Title 代表輸出的 Excel 的文件内容的標題 。

ToExcel( string tableName, string xLSFileName, string Title, string Filter)

用來輸出 InfoDataSet 的資料到Excel 中 ， TableName 代表為 InfoDataSet 的 TableName 名稱， XLSFileName 可以包函 Path ， Title 代表輸出的 Excel 的文件内容的標題， Filter 則代表 Filter 再次過濾資料條件 。

ToExcel(string tableName, string xLSFileName, string Title, string Filter, string Sort)

用來輸出 InfoDataSet 的資料到Excel 中 ， TableName 代表為 InfoDataSet 的 TableName 名稱， XLSFileName 可以包函 Path ， Title 代表輸出的 Excel 的文件内容的標題， Filter 則代表 Filter 再次過濾資料條件 ， Sort 代表輸出資料的排序方式 。

ToExcel(string tableName, string xLSFileName, string Title, string Filter, string Sort, List< string>  IgnoreColumns)

用來輸出 InfoDataSet 的資料到Excel 中 ， TableName 代表為 InfoDataSet 的 TableName 名稱， XLSFileName 可以包函 Path ， Title 代表輸出的 Excel 的文件内容的標題， Filter 則代表 Filter

再次過濾資料條件 ， Sort 代表輸出資料的排序方式， IgnoreColumns 代表不用輸出到 Excel 的欄位名稱 。

ToCSV(int tableIndex, string xLSFileName)

用來輸出 InfoDataSet 的資料 為 CSV 格式，解決 Excel 2002 之前版本不支援 XML 格式的問題 ，TableIndex 代表 所要輸出的 Table 名稱的索引。

ToCSV(string tableName, string xLSFileName)

用來輸出 InfoDataSet 的資料 為 CSV 格式，解決 Excel 2002 之前版本不支援 XML 格式的問題 ，TableName 代表為 InfoDataSet 的TableName 名稱。

【其他說明】

在設計過程中，如果將此元件的Active屬性設為True後，可以直接在元件上Double Click打開欄位選擇窗口，點選要使用的欄位，將其拉向表單中，會自動生成對應的編輯元件，例如InfoTextBox，RichTextBox, Label, DateTimePicker等元件，並會自動與Table的欄位Binding好。因為可以一此拖出多個欄位，因此可以在”Optoins”這頁中設定欄位排列方式與欄位間隔。 另外此項功能支持資料字典(Data Dictionary)功能，在產生各元件時，會自動到COLDEF這個系統表中抓取對應的Caption設定。例如，如果在COLDEF中已經設定ORDER表的OrderID字段的Caption為「訂單編號」，則用此欄位選擇拉出的InfoTextBox上的對應Label顯示的就是「訂單編號」，同時也會自動依D.D.(系統Table:ColDef)來決定其MaxLength的長度，因為如果沒定義好時，User萬一輸出超過時，後端資料庫會發生錯誤並退回，因此，最好在EEPManager的D.D.事先將FieldLength設定好(系統會自動讀取)。