【功能說明】
用途：使用於Web網頁中，此元件主要功能是為了能連繫Web各資料元件與WebDataSet彼此的互動關係，也就是說任何資料都是透過A/P Server的InfoCommand取得數據後交給WebDataSet，WebDataSet是在IIS伺服器上，再由WebDataSet將資料交給WebDataSource，透過WebDataSource能與所有Web上的各元件互動呈現資料，如果其所連結的元件在編輯狀態下，也可以透過WebDataSource將資料異動給WebDataSet，最後再透過WetDataSet回到A/P Server的UpdateComp元件來自動進行資料的異動(如新增/更改/刪除功能等)。WebDataSource元件有兩種取得資料的方式，一種是接到上述的WebDataSet上，另一種是可以直接在WebDataSource定義SelectAlias與SelectCommand，前者必須都要定義InfoCommand與WebDataSet，才能使用：後者就容易多了，只要直接定義SelectAlas與SelectCommand即可直接使用，不必另外定義WebDataSet與InfoCommand，方便許多。
【元件屬性】
(ID)(名稱)(string)
元件名稱，用於識別該元件。
WebDataSetID(資料集) (string)
設定要對應到那個WebDataSet上。注意，這個WebDataSet必須在”Component
Designner”中執行過WebDataSet右鍵的”Save”功能後才能選擇到該WebDataSet。
DataMember(資料成員)(string)
對應的資料表名稱，此可以對應到一個WebDataSet資料集中的某一個Table (因為一個WebDataSet會有多個Table的內容)；本屬性要搭配WebDataSetID共同使用，不能單獨使用，也是必須執行過WebDataSet的右鍵”Save”功能後才能選擇。
SelectAlias(資料庫名稱)(string)
SelectCommand的指定資料庫名稱，此名稱定義在EEPNetServer.EXE的”DB Manager”中，為一個虛擬的資料庫名稱。
SelectCommand(SQL命令)(string)
直接以SQL命令來取得本元件的資料，資料來自SelectAlias所指定的資料庫中，此屬性設定後，WebDataSetID與DataMember都會無效，因為兩者只能選擇其一來運作，不是使用WebDataSetID對應到WebDataSet就是直接使用SelectCommand來下達SQL命令，使用SelectCommand的好處是簡單容易下達SQL命令(也可以使用 “…”的按鈕呼叫我們的SQL Builder來輔助設計SQL命令)。
AutoApply(自動存檔)(bool)
這與WebDataSet內的AutoApply是一樣的功能，用來設定是否User按下內建的Navigator的OK或外掛是WebNavigator中的OK即會自動執行WebDataSet的Apply存檔動作，預設為True。一般在Master/Detail的Detail中必須要設為False，否則每存一筆Detail，就會回Server存檔一次。
AllowAdd(允許新增)(bool)
指示是否允許新增資料，一般不用設定，系統會自動與WebSecurity元件來搭配。
AllowUpdate(允許更改)(bool)
指示是否允許更新資料，一般不用設定，系統會自動與WebSecurity元件來搭配。
AllowDelete(允許刪除)(bool)
指示是否允許刪除資料，一般不用設定，系統會自動與WebSecurity元件來搭配。
AllowPrint(允許印表)(bool)
指示是否允許列印資料，一般不用設定，系統會自動與WebSecurity元件來搭配。
AutoRecordLock(自動鎖定)(bool)
用來解決資料編輯鎖定的問題，如果AutoRecordLock=True，如下的程序：
1. AutoRecordeLockMode為Reload，則在更改資料時，會到A/P Server下載該筆最新的資料，以免資料過期；如果AutoRecordLockMode為NoneReload，則更改前不會下載最新資料，以增加效能。
2. 當InfoBindingSource資料被更改時，A/P Server會自動記錄該User，Table，KeyValue到一個XML文件中。
3. 如果已經有其他User更改此筆資料，則會自動告訴此User；該資料正在被其他使用者更改中，如果沒有則可以進行編輯。
4. 編輯存檔後，就會清除自己所編輯的XML資料狀態，讓別的使用者可以輸入。
AutoRecordLockMode(鎖定模式)(enum)
Reload 在更改資料時，會到A/P Server下載該筆最新的資料，以免資料過期，NoneReload則更改前不會下載最新資料，以增加效能。
AutoApplyForInsert(新增時自動存檔)(bool)
預設為False，此屬性用來控制是否在新增狀態下按Naivgator的"OK"時自動去"APPLY"(存檔)，此必須配合AutoApply為True，用在Master/Detail時，Master為自增值(Identity)的狀態下，必須在User按下"OK"時，先讓Master到存到後端並取回自動編號，才能讓Detail可以繼續輸入。一般在Master/Detail情況下，WebNavigator的"OK"不會引發Master的Apply，即使AutoApply=True，因為"OK"是為了讓User可以繼續輸入Detail資料，而不是真正讓Master存檔，一直到User 按下"Apply"才會讓Master/Detail一起存檔。 用AutoApplyForInsert可以控制讓Master優先存檔來取得自動編號。
CacheDataSet( 存儲 DataSet)(bool)
預設為 False ，此屬性用來控制 InnerDataSet 的存儲在 Session 或者 ViewState 兩种存儲方式。設為 True 時，可以大幅減少 EnabledViewState 為 rue 所增加出來的網頁流量 , 因為 EnableViewState 會將 InnerDataSet 的資料 ( 來自 WebDataSet) 也序列化到前端網頁中 , 尤其是 Master/Detail 的資料會讓 User 的網頁效能變差 , 使用 CacheDataSet 之後 , 就會讓 InnerDataSet 改 Cache 到 Session 中 , 不會被序列化到網頁中 , 可以大幅提升網頁數度 , 但此會增加 IIS Server 的記憶體負擔 , 如果 User 數很多時 , IIS Server 的 RAM 須倍數增加。
CommandPacketRecord(SQL 命令傳送記錄數 )(int)
此屬性可是讓 SelectCommand 方式取得的 WebDataSource 也可以有 PackageRecord 功能，預設為 -1
【功能函數】
bool ApplyUpdates()
將已異動的資料，存檔到後端的A/P Server上，並返回成功與否。
bool SetWhere(string strWhere)
以傳入的Where條件到原SelectCommand或InfoCommand所指定的SQL語法中，並重新獲取新的資料。
void ExecuteSelect(object selectedObject)
在Master/Detail中，Detail是以本Method來取得與Master資料的同步，SelectObject一般是指其Master的資料元件，可以是WebFormView或WebDetailView等元件，並注意此SelectObject中必須存在Master/Detail的關連欄位才能同步。
如：Detail.ExecuteSelect(wfvMaster); // 從 wfvMaster這個WebFormView元件中取的鍵值後，對Detail進行同步對應。
DataBind(); // 讓WebDataSource資料可以與其相對的Control來重新進行資料綁定。
void ExecuteAdd(object selectedObject)
在Master/Detail中，如果Master新增時，Detail資料應該要產生一筆空的資料讓User來輸入，就必須是以本Method來產生。SelectObject一般是指其Master的資料元件，可以是WebFormView或WebDetailView等元件。
如：if (e.CommandName == "cmdAdd") //在WebNavigator中檢查是否按到新增
{
Detail.ExecuteAdd(wfvMaster); //從wfvMaster這個WebFormView元件中取的鍵值後，對Detail清空資料。
DataBind(); //讓WebDataSource資料可以與其相對的Control來重新進行資料綁定。
}
void ExecuteSync(object selectedObject)
可以用來同步本WebDataSource的資料與SelectedObject的目前筆資料，系統會自動從SelectObject(通常為WebGridView元件)中取出鍵值，對定自己的WebDataSource以SetWhere()來取得最新目前筆增料。
如：在WebGridView1的SelectedIndexChanged事件中寫著下列程式來同步Master/Detail的資料指向WebGridView1同一筆資料：
protected voidWebGridView1_SelectedIndexChanged(objectsender, EventArgs e)
{
Master.ExecuteSync(WebGridView1); // 以WebGridView1的鍵值同步Master的資料
DataBind();
Detail.ExecuteSelect(wfvMaster); // 以wfvMaster的鍵值同步Detail的資料DataBind();
}
ToExcel(string TableName )
用來輸出 WebDataSource 的資料到 Excel 中， TableName 代表 所要輸出的 InfoCommand 的名稱 。
ToExcel(string TableName ,string Filter)
用來輸出 WebDataSource 的資料到 Excel 中， TableName 代表 所要輸出的 InfoCommand 的名稱 ， Filter 則代表 Filter 再次過濾資料條件。
ToExcel(string TableName ,string Filter ,bool Open )
用來輸出 WebDataSource 的資料到 Excle 中， TableName 代表 所要輸出的 InfoCommand 的名稱 ， Filter 則代表 Filter 再次過濾資料條件 ， Open 代表打開 Excel 下載畫面 。
ToExcel(string TableName ,string Filter ,bool Open,string Title )
用來輸出 WebDataSource 的資料到 Excel 中， TableName 代表 所要輸出的 InfoCommand 的名稱 ， Filter 則代表 Filter 再次過濾資料條件 ， Open 代表打開 Excel 下載畫面， Title 代表輸出的 Excel 的文件内容的標題 。
ToExcel(string TableName ,string Filter ,string Sort,bool Open,string Title )
用來輸出 WebDataSource 的資料到 Excel 中， TableName 代表 所要輸出的 InfoCommand 的名稱 ， Filter 則代表 Filter 再次過濾資料條件 ， Sort 代表輸出資料的排序方式， Open 代表打開 Excel 下載畫面， Title 代表輸出的 Excel 的文件内容的標題 。
ToExcel(stringTableName, stringFilter, stringSort, boolOpen, stringTitle, List< string> IgnoreColumns)
用來輸出 WebDataSource 的資料到 Excel 中， TableName 代表 所要輸出的 InfoCommand 的名稱 ， Filter 則代表 Filter 再次過濾資料條件 ， Sort 代表輸出資料的排序方式， Open 代表打開 Excel 下載畫面， Title 代表輸出的 Excel 的文件内容的標題， IgnoreColumns 代表不用輸出到 Excel 的欄位名稱。
ToExcel( int TableIndex )
用來輸出 WebDataSource 的資料到 Excel 中， TableIndex 代表 所要輸出的 Table 名稱的索引 。
ToExcel( int TableIndex ,string Filter)
用來輸出 WebDataSource 的資料到 Excel 中， TableIndex 代表 所要輸出的 Table 名稱的索引 ， Filter 則代表 Filter 再次過濾資料條件。
ToExcel( int TableIndex ,string Filter ,bool Open )
用來輸出 WebDataSource 的資料到 Excle 中， TableIndex 代表 所要輸出的 Table 名稱的索引 ， Filter 則代表 Filter 再次過濾資料條件 ， Open 代表打開 Excel 下載畫面 。
ToExcel( int TableIndex ,string Filter ,bool Open,string Title )
用來輸出 WebDataSource 的資料到 Excel 中， TableIndex 代表 所要輸出的 Table 名稱的索引 ， Filter 則代表 Filter 再次過濾資料條件 ， Open 代表打開 Excel 下載畫面， Title 代表輸出的 Excel 的文件内容的標題 。
ToExcel( int TableIndex ,string Filter ,string Sort,bool Open,string Title )
用來輸出 WebDataSource 的資料到 Excel 中， TableIndex 代表 所要輸出的 Table 名稱的索引 ， Filter 則代表 Filter 再次過濾資料條件 ， Sort 代表輸出資料的排序方式， Open 代表打開 Excel 下載畫面， Title 代表輸出的 Excel 的文件内容的標題 。
ToExcel( intTableIndex, stringFilter, stringSort, boolOpen, stringTitle, List< string> IgnoreColumns)
用來輸出 WebDataSource 的資料到 Excel 中， TableIndex 代表 所要輸出的 Table 名稱的索引 ， Filter 則代表 Filter 再次過濾資料條件 ， Sort 代表輸出資料的排序方式， Open 代表打開 Excel 下載畫面， Title 代表輸出的 Excel 的文件内容的標題， IgnoreColumns 代表不用輸出到 Excel 的欄位名稱。
例如：
List<string> lst = new List<string>(new string[2]{"Field1","Field2"});
infoDataSet1.ToExcel(0, "C:\\my.xls", "", "", "", lst);
ReadFromTxt(int tableIndex, string txtFileName)
用來提供外部讀取 Txt 文件， TableIndex 代表 DataSource 中 Table 的索引， txtFileName 代表為 Txt 文字檔格式的文件所在路徑，其中 txt 文件内容中欄位間是以 "," 或 "TAB" 為間格符號 , 資料是以 "LF" 換行作為資料格式。
ReadFromTxt(string TableName, string txtFileName)
用來提供外部讀取 Txt 文件， TableName 代表為 WebDataSource 的 TableName 名稱， txtFileName 代表為 Txt 文字檔格式的文件所在路徑，其中 txt 文件内容中欄位間是以 "," 或 "TAB" 為間格符號 , 資料是以 "LF" 換行作為資料格式。
ReadFromXls(int tableIndex, string xlsFileName)
用來提供外部讀取 Excel 文件， TableIndex 代表 DataSource 中 Table 的索引， xlsFileName 代表為 xls 文字檔格式的文件所在路徑。
public void ReadFromXls(int tableIndex, string xlsFileName, int beginrow, int begincell)
用來提供外部讀取 Excel 文件， TableIndex 代表 DataSource 中 Table 的索引， xlsFileName 代表為 xls 文字檔格式的文件所在路徑， BeginRow 表示 讀入的起始 Row 號， BeginCol 表示讀入的起始 Col 號 . 。
ReadFromXls(string tableName, string xlsFileName)
用來提供外部讀取 Excel 文件， TableName 代表為 WebDataSource 的 TableName 名稱， xlsFileName 代表為 xls 文字檔格式的文件所在路徑。
public void ReadFromXls(string tableName, string xlsFileName, int beginrow, int begincell)
用來提供外部讀取 Excel 文件， TableName 代表為 WebDataSource 的 TableName 名稱， xlsFileName 代表為 xls 文字檔格式的文件所在路徑， BeginRow 表示 讀入的起始 Row 號， BeginCol 表示讀入的起始 Col 號 . 。
ToCSV( intTableIndex)
用來輸出 WebDataSource 的資料 為 CSV 格式，解決 Excel 2002 之前版本不支援 XML 格式的問題 ， TableIndex 代表 所要輸出的 Table 名稱的索引。
ToCSV( stringTableName)
用來輸出 WebDataSource 的資料 為 CSV 格式，解決 Excel 2002 之前版本不支援 XML 格式的問題 ， TableName 代表為 WebDataSource 的 TableName 名稱。
【事件】
Adding(Eventarg e)
對WebDataSource新增時會觸發此事件。
Updating(Eventarg e)
對WebDataSource更改時會觸發此事件。
Deleting(Eventarg e)
對WebDataSource刪除時會觸發此事件。
ApplyError(EventArg e)
如同InfoDataSet的ApplyError一樣，用來當WebDataSource Apply資料到後端發生Error時，就會觸發本事件，用來對錯誤訊息做進一步的處理，如下的案例：
protected void Master_ApplyError(object sender, Srvtools.ApplyErrorEventArgs e)
{
// 檢查是否為自定訊息
if (e.Exception.InnerException.Message == "StockNotEnough")
{
Label1.Text = "Stock Not Enough!"; // 自行處理
e.Cancel = true; //讓系統知道後端有錯誤
}
}
【其他說明】
1. 使用WebDataSet的方式時，雖然在設計模式中我們已經定義好WebDataSource.DataSourceID為那一個WebDataSet，但是因為WebDataSet在Web Server中並不能被保存狀態(上一個服務存在下一個服務就已經不存在)，因此，你必須在用到WebDataSet的網頁上的Page_Load中加上下列的指令，才能正常使用WebDataSource，使用時所有WebDataSource如果是對應到WebDataSet時，都必須對應，如下：
protected void Page_Load(object sender, EventArgse)
{
if (!IsPostBack)
{
InitializeComponent(); // 要執行此命令才會讓WebDataSet存在Web Server上
Master.DataSource = WebMaster; // 設定 Master這個WebDataSource資料來自WebMaster這個WebDataSet.
Detail.DataSource = WebMaster; // Detail也是來自WebMaster
即可View.DataSource = WebView; // View這個WebDataSource資料來自WebView這個WebDataSet.
}
}
注意，如果你使用的是SelectCommand方式，則在Page_Load()中就可以按
以上方式來處理。
2. 使用WebDataSet連結資料方式與SelectCommand直接取得資料的方式中，其中有一些不小的差異，說明如下：
(1)
WebDataSet有自己的InfoCommand與UpdateComp元件，而SelectCommand是固定連結到GLModule的”cmdRefValUse”這個共用的InfoCommand，因此SelectCommand並沒有UpdateComp來進行資料異動的回寫，所以就只能是唯讀的模式。
(2) 也因為SelectCommand沒有WebDataSet元件可以設定PackedRecords數，並能進行緩存的處理，所以，SelectCommand的方式只能一次將資料下到Web Server上，如果資料有數千或數萬筆資料時，最好還是改用WebDataSet才能有較好的效能(因為有了PackedRecord功能)，除非你能在SelectCommand中以Where來降低資料筆數。
| Converted from CHM to HTML with chm2web Pro 2.85 (unicode) |