WebTranslate

【功能說明】

用途：使用於 Web 網頁中， 此元件的主要功能是 自動接受並傳遞兩個網頁中的資料，專門用於 WebGridView 來連結到另一個網頁上進行 Update 和 Insert 與查看功能，在另一個網頁中就是用本元件來接收原網頁所傳入的鍵值與設定來進行另一頁面的新增更改與查看功能，最後也必須將更改或新增的資料傳回原網頁。 WebTransLate 另一重要用途就是可以配何 WebRefButton( 自定連結按鈕 ) ，讓 WebRefButton 可以另外連結一個網頁，並以 WebTransLate 來定義傳回值，傳回另一頁面的資料回 WebRefButton 的原網頁。

【元件屬性】

(ID) （名稱）（ string ）

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

DataSourceID （ 資料源 ） (string)

所要對應的 WebDataSource ，系統會以傳過來的鍵值對指定的 DataSourceID 進行查詢動作 ( 如過為新增動作則會自動清空 ) 。

AllowToReturn （允許傳回） (bool)

可以透過此控制是否在 OK 結束時要關閉此網頁並傳回資料回到原網頁中， True 代表會結束本網頁， Falase 則不會。

ShowDataStyle( 資料類型 )( string )

設置與其連結的資料元件類型，目前支援 WebFormView ， WebDetailsView ， WebGridView ， ListBox 等四種。但 WebGridView 一般是配合 ReferanceOnly=True 時使用，用於傳回欄位值。

BindingObject( 連結元件 ) （ string ）

設置與之綁定連結的資料元件名稱，用來控制與其元件的相互互動關係， BindingObject 的類型應與 ShowDataStyle 相同 。

ReferanceOnly( 僅傳回參考值 )(bool)

用來設定是否配合 WebRefButtons 傳回部份欄位參考值， True 代表按 OK 時會傳回 RefReturnFiels 給原網頁， False 代表按 OK 會回存此 Insert/Update 的資料到後端，並回原網頁更新資料。

RefReturnFields( 傳回欄位名稱 )(collection)

用來設定當 ReferanceOnly=True 時，所要傳回的欄位。

FieldName( 欄位名稱 )(string) ： 要傳回的欄位名稱，指 DataSourceID 的欄位。

GetDataSourceValue( 傳回欄位值 )(bool) ： 是否以欄位方式傳回，如果 True 代表以欄位的方式傳回，如果為 False ，則 FieldName 可以不必設定，因為代表將在 OKClick 由設計者自行定義此傳回值。

OKButtonCaption( 確定抬頭 )( string )

設置確定按鈕的抬頭。

OKButtonWidth( 確定寬 度 )(int)

設置確定按鈕的寬度。

OKButtonHeigth( 確定 高度 )(int)

設置確定按鈕的高度。

CancelButtonCaption( 取消抬頭 )( string )

設置取消按鈕的抬頭。

CancelButtonWidth( 取消寬度 )(int)

設置取消按鈕的寬度。

CancelButtonHeigth( 取消高度 )(int)

設置取消按鈕的高度。

ContinueAdd( 繼續新增 )(bool)

當 ContinueAdd=True 時 , 在 新增 模式下按下 'OK' 時 , 對該資料存檔後 , 不會關閉該網頁 , 而改用 AddNew 的動作 , 持續讓 User 新增資料 , 一直到 Cancel 為止才會關閉回來。

 

【方法】

SetRefReturn(int index,string var)

用來自定傳回值，用於 ReferanceOnly=True 時，須要以 RefReturnFields 傳回到 WebRefButtons 的 MatchControls 時使用， index 代表 RefRetrunFields 中第幾個欄位， var 代表要傳回的內容值 ，此函數必須在 OKClick 事件中使用。

如：

protected void WebTranslate1_OKClick(object sender,EventArgs e)

{

   WebTranslate1.SetRefReturn(0, TextBox1.Text);

// 將 TextBox1.Text 設給 WebRefButtons 的第一個 Control

   WebTranslate1.SetRefReturn(1, TextBox2.Text);

// 將 TextBox2.Text 設給 WebRefButtons 的第二個 Control

}

 

【事件】

OKClick

按下確定按紐（ OK ）時觸發本事件。

CancelClick

按下取消按紐（ Cancel ）時觸發本事件。

 

【其他說明】

如果使用於 ReferanceOnly=True 時，須注意 RefReturnFields 的數量一定要與 WebRefButton 的 MatchControls 數量相符，因為系統會依 RefReturnFields 的傳回次序，依次傳回到 WebRefButton 的 MatchControls 所設定的 Control 中。

 

【範例】

這是用來檢查 WebTranslate 所對應的 WebFormView 在新增前的檢查程式：

protected void WebFormView1_ItemInserting(object sender, FormViewInsertEventArgs e)

{

TextBox ctrl = (TextBox) WebFormView1.FindControl("CompanyNameTextBox"); // 假設名稱為 CompanyNameTextBox

if (string.IsNullOrEmpty(ctrl.Text))

{  

     e.Cancel = true; // 用來取消 Insert 的動作

               Page.Response.Write("<script>alert(' 公司名稱不能為空 ! ');</script>");  // 顯示警告訊息

              WebTranslate1.AllowToReturn = false ; // 用來防止結束此網頁

   }

}