WebDetailsView

 

【功能說明】

用途：使用于 Web 網頁中，繼承自 DetailsView 元件， 此元件的主要功能是一頁一筆資料及表格的方式來顯示資料表內容。

【元件屬性】

ID( 元件名稱 ) (string)

用於識別該組件。

DataSourceID ( 資料源 ) (string)

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

Caption( 抬頭 )(string)

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

ExpressionFieldCount ( 運算式欄位數 ) ( int)

用於指示該 WebDetailsView 中 ExpressionField 的數量，設置此屬性後設計者必須進入 Fields 屬性來對 ExpressionField 進行設定 ( 包括 Expression 屬性等 ) ，才能使用。

Fields ( 欄位明細 ) (collection)

指 WebDetailsView 中所有欄位的明細，其 Fields 的屬性說明如下：

  HeaderText ( 表頭文字 )(string): 每個欄位左邊的欄位表頭內容。

  HeaderImageURL ( 表頭圖示 )(string): 每個欄位左方的表頭圖示。

  ApplyFormatInEdit ( 編輯時使用格式 )( bool): 此欄位編輯時是否使用 DataFormatString 格式。

InsertVisibel ( 新增顯示 )( bool): 新增時是否要顯示此欄位。

Visibll ( 顯示 )( bool): 在 WebDetailsView 中是否顯示該欄位。

ReadOnly ( 唯讀 )( bool): 是否唯讀，不能新增 / 更改 / 刪除。

ShowHeader ( 顯示表頭 )( bool): 該欄位是否顯示左邊的抬頭。

DataField ( 欄位名稱 )( strring): 對應的欄位名稱。

DataFormatString ( 欄位格式 )( strring): 對應的欄位格式內容，請參考 VS 手冊說明。

ItemStyle( 資料頁面型態 ): 設定此欄位在顯示時其頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。

HeaderStyle( 表頭頁面型態 ): 設定此欄位抬頭的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。

FooterStyle( 表尾頁面型態 ): 設定此欄位表尾頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。

CreateInnerNavigator ( 內建 Navigator)( bool)

用於指示是否在該 WebDetailsView 中建立內建的 WebNavigator ，一般此 Navigator 會自動放在 DetailsView 的 Footer 中，內建的 Navigator 會預設新增 / 更改 / 刪除 / 查詢的按鈕。

GetServerText (Server 端訊息 )( bool)

控制內建 WebNavigator 所顯示文字，是否去抓取 Server 端的多國語言訊息，即存在 SYSMSG.XML 中的 WebNavigator 訊息。

InnerNavigatorShowStyle ( 內建 Navigator 型態 ) ( enum)

可設定為 ( HyperLink,Image,Button) ，只內建 WebNavigator 所顯示按鈕的外觀形式， HyperLink 代表連結 Label ， Image 代表圖示， Button 代表按鈕。

InnerNavigatorLinkLabel ( 對應狀態標籤 ) (string)

可以將內建 Navigator 的狀態訊息對應到一個 Label 上來顯示，狀態一般會有：瀏覽 / 更改中 / 新增中 / 存檔成功 / 存檔放棄等訊息。

NavControls (Navigator 明細 )(collection)

可以設定內建 Navigator 的各按鈕的明細，其屬性說明如下：

  ControlVisible ( 是否顯示 )( bool) ： 該按鈕是否顯示。

  ImageURL ( 圖示 URL)( bool) ： 該按鈕的對應 URL 圖檔案。

  MouseOverImageURL ( 作用圖示 URL)( bool) ： 該按鈕 Mouser 移過所對應的 URL 圖檔案。

  Size  ( 寬度大小 )( int) ： 該按鈕的寬度大小。

  ControlName ( 元件名稱 )( bool) ： 該按鈕的元件名稱。

  ControlText ( 按紐文字 )(string) ： 該按鈕的文字內容。

  ControlType ( 按紐類型 )( enum) ： 該按鈕的型態，可設為 ( HyperLink,Image,Button) 。

  在 WebDetailsView 中預設有新增 / 更改 / 刪除 / 存檔 / 取消 / 查詢等按鈕。

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

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

EditRowStyle( 編輯頁面型態 )

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

RowStyle( 資料頁面型態 )

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

FooterStyle( 表尾頁面型態 )

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

InsertRowStyle( 新增頁面型態 )

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

EmptyDataRowStyle( 空白資料型態 )

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

PagerStyle( 分頁頁面型態 )

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

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

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

 

【事件】

此元件無事件。

【功能函數】

  ExecuteSync ( GridViewCommandEventArgse)

可以用此來讓 WebGridView 同步 WebDetailsView 的資料，之前的 WebDataSource.ExecuteSync () 是用來同步兩個不同的 WebDataSource ，在此則用來同步同一個 WebDataSource 的 WebGridView 與 WebDetailsView ，如在 WebGridView 的 RowCommand 事件中去執行 WebDetailsView.ExecuteSync 事件，如下：

　 protected void wgvDetail_RowCommand(object sender, GridViewCommandEventArgse)

　 {

　　 if ( e.CommandName== "Select")

　　　 {

　　　　 WebDetailsView1.ExecuteSync( e);

　　　 }

　 }

 

【其他說明】

1.    如果要刪除 WebDetailsView 中的 ExpressionField ，必須先在 Fields 屬性中刪除此 ExpressionField ，再將 ExpressionFieldCount 屬性的值減去相應已刪除 ExpressionField 的數量即可。

2.    WebDetailsView 與 WebFormView 最大不一樣的處就是 WebDeailsView 只能有一列欄位往下排，不像 WebFormView 是可以依情況左右分成多個 Column 來排列。

3.    如果把 WebDetailsView 的某個欄位設成 readonly , 但是新增時還是可以編輯 , 是要將該欄位的 InsertVisible 設為 False 即可防止在新增時可以輸入的問題。