WSDataSource


【功能說明】


用途:使用於Web網頁中,此元件主要功能是為了連接資料庫,透過WSDataSource能與Web上的各元件互動呈現資料。WSDataSource元件有兩種取得資料的方式,一種是通過設定資料庫的連接字串,另一種是可以直接在站點中的ws.config文件中定義資料庫的連接字串。


【元件屬性】


ID(名稱)(string)


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


ConnectinStrings(連接資料庫)(string)


通過設定資料庫的連結字串來取得資料來源。


ConnectionType(資料庫類型)(enum)


資料庫的類型包括:SQLServer 2000(含)以上版本、Oracle 9i(含)以上版本。


TableName(資料來源)(string)


所要連接的資料表名稱。


KeyFields (欄位明細)(collection)


主鍵的設定(如果要配合GridView對資料表進行刪除操作,則必須設定主鍵)


UpdateColumns (欄位明細)(collection)


設定需要更新的欄位(在這裡設定的欄位,在Edit了之後才會被存入資料庫中)


TopSelect(計數)(int)


從指定資料開始選定記錄的條數(0為所有記錄)。例如:TopSelect=1從第一條資料開始選定記錄


ActiveControl(過濾資料)(bool)


是否配合資料表中的Active欄位對資料進行過濾(ActiveControl =true:選擇資料庫欄位Active='y'的數據;ActiveControl =false不對資料進行過濾)


OrgParameters(enum)


設定Org值的來源Url(連結中的屬性),Session(頁面Session中的參數)


OrgControl(過濾資料)(bool)


是否配合資料表中的Org欄位對資料進行過濾(OrgControl= true:選擇資料庫欄位Org=『Org來源的資料;OrgControl=false不對資料進行過濾)


BranchParameters(enum)


設定Branch值的來源Url(連結中的屬性),Session(頁面Session中的參數)


BranchControl(過濾資料)(bool)


是否配合資料表中的Branch欄位對資料進行過濾(BranchControl =true:選擇資料庫欄位Branch=『Branch來源的資料;BranchControl =false不對資料進行過濾)


IssueDateControl(過濾資料)(bool)


是否配合資料表中的IssueDate欄位對資料進行過濾(IssueDateControl= true:選擇資料庫欄位IssueDate<「當天日期」的數據;IssueDateControl= false不對資料進行過濾)


ExpDateControl(過濾資料)(bool)


是否配合資料表中的ExpDate欄位對資料進行過濾(ExpDateControl =true:選擇資料庫欄位ExpDate>=「當天日期」的數據;ExpDateControl =false不對資料進行過濾)


DateFlag(過濾資料)(bool)


是否配合資料表中的DateFlag欄位對資料進行過濾(DateFlag= true:選擇資料庫欄位DateFlag ='Y'的數據;DateFlag=false不對資料進行過濾)


DateType(新聞類別)(string)


是否配合資料表中的DateType欄位對資料進行過濾(選擇資料庫欄位DateType =『用戶輸入的資料)


AlwaysClose(bool)


是否在網頁讀取時讀取數據資料。(True為不讀取)


ParametersField(string)


用於和WSGridView以及WSDataListEditURL達到跨頁面篩選資料的效果。(當A頁面上的WSDataSource的此屬性設定的IDField,並且與其連接的WSGridViewWSDataList有設定EditURL有設定跳轉網頁,那麼在網頁跳轉的同時會自動加上ParametersField=ROW[ParametersField]的條件,當接收的B頁面中的WSDataSource的此屬性也同樣設定了某個欄位的話,則在篩選資料的時候會自動在SQL語句後加上ParametersField=『this.Page.Request.QueryString[ParametersField]』的條件)


【其他說明】


EasilyWebSite的工程下有一個名為WS.config的檔,裡面存放是預設的ConnectionString,為了方便用戶的工程方便移植到其他的機器上,所以會在WS.config裡存放一個預設ConnctionString,這樣在製作網頁的時候,所有元件上的ConnctionString可以不用設定,程式會本地的WS.config去讀取,這樣如果換了其他的機器,不需要每個元件都去修改,只需修改一份WS.config就可以了。如果用戶希望使用不同的ConnctionString,一樣可以在各個控制項的ConnctionString屬性裡設定