【功能說明】

用途：使用於Web網頁，繼承自DataList元件，此元件的主要功能是顯示資料源的多筆記錄，一次能顯示多筆，並以WebFormView的顯示方式來進行，此WebDataList可以應用於欄位較多且一次要顯示多筆的資料顯示，如討論區各個發言者的言論就是以WebDataList來負責顯示各個資料。本WebDataList只能用在唯讀的模式上，無法進行新增/更改作業，如有必要可以須另外貼入WebFormView或WebDetailsView等來進行資料的編輯。

【元件屬性】

(ID)(元件名稱)(string)

用於識別該組件。

DataSourceID (資料源)(string)

對應到WebDataList的資料源代號，就是指WebDataSource。

LayOutColNum(左右列數)(int)

用來設定WebDataListView中顯示資料欄位的左右列數，系統會自動在此DataListView內建立Table格線於頁面中，以方便設計者處理欄位的位置對齊，但必須注意，此屬性必須在未設定DataSourceID之前就要事先設定好，也就是當DataList還沒有欄位前，否則無效。

RepeatColumns(重複欄數)(int)

用來設定WebDataListView中顯示資料區域的左右欄數，與LayOutColNum不同的是，RepeatColumns代表左右要重複複製的區域數量，一個區域內可以再依LayOutColNum來定義左右的欄位數量，因此LayOutColNum即代表內層，RepeatColumns則代表外層。本屬性不設定時為0，代表只有一個區域。

RepeatDirection(重複方向)(enum)

用來當RepeatColumns設定大於1時，要排列的方向，Horizontal代表優先由左至右，Vertical代表優先由上到下。

Caption(抬頭)(string)

元件上面的抬頭文字內容。

 HorizontalAlign(左右對齊方式)(enum)

用來設定左右的對齊方式，可以利用此屬性設定此元件的版面靠左/靠右/靠中等。

 

EditItemStyle(編輯頁面型態)

用來設定更改編輯時其頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。

 

ItemStyle(資料頁面型態)

用來設定資料顯示時其頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。

 

HeaderStyle(表頭頁面型態)

用來設定表頭頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。

FooterStyle(表尾頁面型態)

用來設定表尾頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。

EmptyDataText(空白資料文字)(string)

用來設定空白資料時所要顯示的文字內容。

 

 AllowPaging( 允許翻頁 )(bool)

 用來表示 DataList 是否允許翻頁，預設為 False 。

 

 PageSize( 分頁大小 )(int)

 用來表示 DataList 一頁中允許的資料筆數。

 

【其他說明】

本元件是專用於顯示資料源中多筆記錄，與WebFormView相近，不同的是WebFormView一次只能顯示一筆資料，但WebDataList元件則是一次顯示多筆資料，並能與WebFormView來配合進行資料的編輯與輸入。