WebDropDownList

 

【功能說明】

用途：使用於 Web 網頁中， 此的主要功能是以下拉方式來顯示選項內容，其資料來源可以是事先定義好的，也可以是另一個資料表的來源。

【元件屬性】

ID( 名稱 ) (string)

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

Items( 項目內容 ) (string[])

在此設定下拉時可以選擇的項目內容，可以設定為多個，但如果有設定 DropDownList 的 DataSourceID 代表其資料來自另一個資料表，則此屬性可以不必設定。

DataSourceID ( 資料源 ) (string)

指 WebDropDonwList 中資料表的資料源代號，就是指 WebDataSource 。

DataTextField ( 顯示欄位 )(string)

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

DataValueField ( 內容值欄位 ) (string)

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

AutoPostBack ( 自動送回 )( bool)

當此 WebDropDownList 的資料有變動時，是否要回到 Server 進行 PostBack 的動作。

Filter ( 過慮條件 )(string)

可以對此對應的 WebDataSource 來進行 Filter 的條件，也就是當下拉 DataSourceID 時，其資料會依照此 Filter 來做為顯示條件。 Filter 與 SetWhere 相近，都會到後端以 Where 的 SQL 語法將資料抓到 WebDropDownList 中。

AutoInsertEmptyData ( 自動空白列 )( bool)

為 True ，可以允許空白資料，系統會自動從 SYSMSG.XML 中取得一個 "-- 請選擇 --" 的空白資料。

DriverObject ( 驅動對象 )(string)

可以控制離開此 WebDropDownList 時，去控制另一個 WebDropDownList 執行 Filter 功能，來達到控制對方動態顯示 DropDownList 內容的功能。

 

【其他說明】

WebDropDownList 也可以配合 WebGridView 一次可以對多筆 WebDropDownList 來設定，只要將 WebDropDownList 貼入 WebGridView 的 ItemTemplate 中即可，再對 WebGridView 的 AutoPostBackWebGridDorpDowns 設為 True 即可。