WebDataList

 

【功能說明】

用途：使用于 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)

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

EditRowStyle( 編輯頁面型態 )

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

RowStyle( 資料頁面型態 )

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

HeaderStyle( 表頭頁面型態 )

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

FooterStyle( 表尾頁面型態 )

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

InsertRowStyle( 新增頁面型態 )

用來設定新增資料時的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。

EmptyDataRowStyle( 空白資料型態 )

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

PagerStyle( 分頁頁面型態 )

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

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

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

AllowPaging( 允許翻頁 )(bool)

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

PageSize( 分頁大小 )(int)

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

 

【其他說明】

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