WebRefVal

【功能說明】

用途：使用於 Web 網頁， 此元件專門用來做為資料輸入的選單，並以 開窗 的方式來顯示資料表，可讓 User 可以選擇後傳回。

【元件屬性】

ID( 名稱 )(string)

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

DataSourceID ( 資料源 ) (string)

指選單中資料表的資料源代號，就是指 WebDataSource ，即此關連選單的資料來源。

DataTextField ( 顯示欄位 )(string)

用來設定要使用那一個欄位來顯示此 WebRefVal ，如可以設定” ProductName ”， WebRefVal 顯示是以產品品名的欄位來顯示。

DataValueField ( 內容值欄位 ) (string)

用來設定要使用那一個欄位來表示其關聯的內容值，用在輸入資料時使用，如可以設定” ProductID ”，做為產品輸入時輸入時的內容值。

BindingValue ( 綁定內容值 ) (string)

指 綁定後的內容值，此值會隨關連欄位的內容改變，一般都是會有 Text 來作為綁定的屬性，但在 WebRefVal 中較為特別，是以 BindingValue 做為綁定的內容值，系統也會以此值來關聯到 DataSourceID 的資料源。此內容值會在 RunTime 時決定，不必設置。

DataBindingField ( 綁定欄位 )(string)

用來設定綁定到原始資料表 WebDataSource 的欄位 ，選擇此欄位時，請務必在 BindingValue 中先行設定到那一個欄位。如要綁定到 ” ProductID” 者，則在 BindingValue 中請設定 Bind(“ ProductID”) ，這樣才能在 DataBindingField 中去選擇此 ” ProductID” 欄位。注意，如果此 DataBindingField 或 BindingValue 沒設定時，則在 RunTime 顯示 WebRefVal 時，則原資料檔在移動時，會因沒有綁定造成資料不會同步移動與關連。

UseButtonImage ( 圖示按鈕 )(bool )

指示 WebRefVal 的按鈕外觀 (true 為 Image,false 為普通 button)

ButtonCaption ( 按鈕抬頭 )(string)

設置當 WebRefVal 的按鈕外觀為 button 時 , 其按鈕上的文字抬頭。

ButtonImageUrl ( 按鈕圖示 )(string)

設置當 WebRefVal 的按鈕外觀為 Image 時 , 按鈕上的圖案的 Url 位址。

ReadOnly ( 唯讀 )( bool)

設置 WebRefVal 是否為唯讀，如果為 True ，則就不會有右邊的選單小 Button 。

Caption( 抬頭 )(string)

關連視窗上面的抬頭文字內容。

HasDataBinding ( 資料綁定 )( bool)

指示 WebRefVal 是否存在資料欄位綁定，配合 BindingValue 與 DataBindingField 來使用，一般預設為 True 。

Columns( 欄位明細 )(collection)

設定打開此關連選單時 , 要顯示哪些欄位，此屬性為一個集合，可同時設定多個要顯示的欄位，如果不設定，則代表顯示所有欄位。其屬性包括：

ColumnName ( 欄位名稱 )(string) ：要顯示的欄位名稱。

HeadText ( 表頭 )(string) ： 要顯示的欄位表頭，此屬性會自動依 DD 資料字典來決定，也可以自行定義更改之。

Width( 寬度 )( int) ： 欄位的寬度，以 pixed 或百分比來決定之。

ColumnMatch ( 欄位對應明細 )(Collection)

設定從 WebRefVal 關聯選單中可以傳回部分欄位內容到原來 WebDataSource 欄位中，此屬性為一個集合，可設定多個欄位的對應關係，也就是說將 User 所選的 WebRefVal 的資料表的欄位值 , 傳回到目前資料表的某些欄位上，其屬性包括：

SrcField ( 來源欄位 )(string) ：指定關選選單上的資料表欄位名稱。

SrcGetValue ( 來源值 )(string) ：當不能單純以 SrcField 的欄位來取值時，則可改用此運算式呼叫另一個程式來傳回自定義的內容值。

DestControlID ( 目的欄位 )(string) ：設定要傳回原網頁上的元件名稱，因為我們內部使用了自動 Java Script 機制，因此傳回的欄位必須以元件的名稱來決定，無法單純以欄位名稱。

WhereItem ( Collection)

當 WebRefVal 被關聯或打開時 , 此時系統會自動以此 Where 的條件到後端重新取資料 , WhereItem 為一個集合，屬性包括 :

FieldName ( 欄位名稱 )(string) ：設定條件的欄位名稱。

Condition( 條件 )( enum) ：共有 =,%,%%,>,<,!=,>=,<= 等，用來控制何種 where 條件。

Value( 內容值 )(string) ：可設定常數或使用 () 的函數引用方式取得動態條件值，如可以利用此 Value 呼叫另一個程式取得其他 TextBox.Text 內容傳回到此 Value 來達到過濾與篩選此 WebRefVal 的條件。

CheckData ( 是否檢查 )( bool)

可以設定是否在 RefTextBox 或 DataGridView 的 RefValColumn 輸入資料時， 檢查其鍵值是否存在。 True 為要檢查， False 則不要。預設為 True 。

為 True 則可以控制資料輸入需為正確 , 如果不正確除了警告外 , 還會清為空白或是恢復原來的內容值  

AllowAddData ( 是否允許資料新增 )( bool)

可控制 WebRefVal 頁面內的 WebGridView 之 Add Button 是否顯示出來 , 並可以新增資料 , 注意此功能僅針對資料來源為 WebDataSet 接上 WebDataSource 者。

IgnoreCase 區分大小寫 ( bool)

true 區分大小寫 , False 代表不區分。

OpenRefHeight ( 頁面高度 )( int)

指 WebRefVal 打開時，頁面高度大小。

OpenRefWidth ( 頁面寬度 )( int)

指 WebRefVal 打開時，頁面寬度大小。

OpenRefLeft ( 頁面左邊位置 )( int)

指 WebRefVal 打開時，頁面左邊位置。

OpenRefTop ( 頁面上面位置 )( int)

指 WebRefVal 打開時，頁面上面位置。

 

【功能函數】

SynchronizeBindingValue ()

用于解決使用者以手 動方式 將 WebRelVal 內 的 TextBox 內 容清除 後，雖然顯示空白，但實際值並未清除， 導致網頁在 Post 後 又 恢復未修改前的值。

 

【其他說明】

1.    WebRefVal 如果資料量過大，配合 WebDataSource 時，請必須改用 WebDataSet 的連接方式，否則會因為資料過大造成 SelectCommand 的用法徒增效能上的困擾，主要是因為 SelectCommand 沒有 PackedRecord 的功能，會一次下載所有資料，不可不慎。

2.    WebRefVal 的開窗選單上，上有查詢功能，可以在開窗選單上再次下達 Where 的語法來高速篩選資料。