Ajax RefVal

  【功能說明】

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

【元件屬性】

ID( 名稱 )(string)

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

DataSourceID ( 資料源 ) (string)

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

DataTextField ( 顯示欄位 )(string)

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

DataValueField ( 內容值欄位 ) (string)

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

BindingValue ( 綁定內容值 ) (string)

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

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

OpenRefHeight ( 頁面高度 )( int)

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

OpenRefWidth ( 頁面寬度 )( int)

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