【功能說明】
用途：使用於Web網頁中，繼承自GridView元件，此元件的主要功能是以表格的方式顯示多筆資料內容。
【元件屬性】
(ID)(元件名稱)(string)
用於識別該組件。
DataSourceID (資料源)(string)
對應到WebGridView的資料源代號，就是指WebDataSource。
AddIndentityField(自增值欄位)(bool)
用來自動增加一個IndentityField自增值欄位，此欄位是由系統產生，並不必使用實體欄位，這裡會自動依WebGridView的次序自動顯示一個序號，用來標示給User查看。
Caption(抬頭)(string)
元件上面的抬頭文字內容。
ExpressionFieldCount(運算式欄位數)(int)
用於指示該WebGridView中ExpressionField的數量，設置此屬性後設計者必須進入Fields屬性來對ExpressionField進行設定(包括Expression屬性等)，才能使用。
Columns (欄位明細)(collection)
設定WebGridView中所有欄位的明細，如下說明：
HeaderText(表頭文字)(string)：每個欄位上方的欄位表頭內容。
HeaderImageURL(表頭圖示)(string)：每個欄位上方的表頭圖示。
ApplyFormatInEdit(編輯時使用格式)(bool)：此欄位編輯時是否使用DataFormatString格式。
InsertVisible(新增顯示)(bool)：新增時是否要顯示此欄位。
Visible(顯示)(bool)：在WebGridView中是否顯示該欄位。
ReadOnly(唯讀)(bool)：是否唯讀，不能新增/更改/刪除。
ShowHeader(顯示表頭)(bool)：該欄位是否顯示上面的抬頭。
DataField (欄位名稱)(strring)：對應的欄位名稱。
DataFormatString (欄位格式)(strring)：對應的欄位格式內容，請參考VS手冊說明。
ItemStyle(資料頁面型態)：設定此欄位在顯示時其頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。
HeaderStyle(表頭頁面型態)：設定此欄位抬頭的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。
FooterStyle(表尾頁面型態)：設定此欄位表尾頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。
AddNewRowControls(新增元件明細)(Collection)
如果你允許WebGridView可以自由新增資料時，系統會自動在WebGridView的Footer中增加一個空的Row讓User新增，一般都會以標準的TextBox來讓User輸入，如果你想在更改或新增時能以特殊的元件來讓User輸入者，可以先將此特殊欄位轉換成TemplateField後(在Columns屬性中轉)，在TemplateField設定時，只能設定ItemTemplate(顯示用)，EditTemplate(更改用)，因為WebGridView並沒有InsertTemplate，因此我們只能定義在FooterTemplate中，除此之外，就是還要在本屬性中將此AddNewRowControls的FieldName要對應上FooterTemplate中的ControlID，這樣即可以讓WebGridView在新增時使用特殊的元件。在此Collenction中，其設定說明如下：
FieldName(欄位名稱)(string)：只要新增的欄位名稱，要與相對的WebGridView欄位對應上。
ControlID(元件名稱)(string)：代表所要對應的元件名稱，就是貼在FooterTemplate中用來新增的元件名稱。
ControlType(元件型態)(enum)：可以設定為TextBox，CheckBox，RefVal，DateTimePicker，DropDownList等。
CreateInnerNavigator(內建Navigator)(bool)
用於指示是否在該WebGridView中建立內建的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(寬度大小)(int32)：該按鈕的寬度大小。
ControlName(元件名稱)(bool)：該按鈕的元件名稱。
ControlText(按鈕文字)(string)：該按鈕的文字內容。
ControlType(按鈕類型)(enum)：該按鈕的型態，可設為(HyperLink,Image,Button)。
在WebGridView中預設有新增/存檔/取消/查詢等按鈕，更改/刪除則一般置於CommandFields中。
HorizontalAlign(左右對齊方式)(enum)
用來設定左右的對齊方式，可以利用此屬性設定此元件的版面靠左/靠右/靠中等。
EditUrl(編輯連結)(string)
可以設定另一連結網頁(.ASPX)來進行新增/編輯/查看資料，即指定到另一的頁的url，該頁須另外自行設計，並且該頁中須配合一個WebTranslate元件，用來控制返回原WebGridView的頁面，並處理返回後資料的更新。
OpenEditHeight(編輯連結高度)(int)
用來設置打開EditUrl頁面時的高度。
OpenEditWidth(編輯連結寬度)(int)
用來設置打開EditUrl頁面時的寬度。
OpenEditUrlInServerMode ( 以 Server 模式打開 編輯連結)( bool)
設置打開 EditUrl 頁面時是否已 Server 模式打開， ServerMode 和 ClientMode 區別在於， ServerMode 時會造成打開 EditUrl 頁面時父畫面出現刷新。
TotalActive(是否加總)(bool)
指示是否在WebGridView的Footer中顯示相應的Total值，Total的欄位將在TotalColumns中定義之。
TotalColumns(加總明細)(collectioon)
用來設定Total的Columns的明細，所設定的Column在WebGridView的Footer中會顯示相應的Total值(前提是TotalActive屬性為true)，此Collection屬性說明如下：
FieldName(欄位名稱)(string)：代表要加總的欄位名稱。
ShowTotal(是否顯示加總)(bool)：代表是否要顯示此欄位的Total值。
TotalMode (加總模式)(enum)：代表此列的Total值的加總模式，可設定為 none：不加總，sum：累加加總，count：記次加總;max：取最大值，min：取最小值，average：取平均值等。
HeaderStyleWrap(表頭文字換行)(bool)
用來統一控制各個Column的HeaderStyle中Wrap的值。
EditRowStyle(編輯頁面型態)
用來設定更改編輯時其頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。
RowStyle(資料頁面型態)
用來設定資料顯示時其頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。
HeaderStyle(表頭頁面型態)
用來設定表頭頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。
FooterStyle(表尾頁面型態)
用來設定表尾頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。
EmptyDataRowStyle(空白資料型態)
用來設定空白資料時其頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。
PagerStyle(分頁頁面型態)
用來設定表尾分頁的頁面上的前景背景顏色，字型，自動換列，邊框顏色型態大小等等。
EmptyDataText(空白資料文字)(string)
用來設定空白資料時所要顯示的文字內容。
TotalCaption(加總抬頭)(string)
能在TotalActive=True時能顯示加總抬頭在Footer上。
AutoPostBackMultiCheckBoxes(多個控制項)(bool)
此專門用來配合一次可以直接在ItemTemplate中輸入多筆CheckBox元件，為True代表啟動，使用時需配合WebGridView中要貼入WebCheckBox元件才能正常運作。
AutoPostBackWebGridDropDown(多個控制項)(bool)
此專門用來配合一次可以直接在ItemTemplate中輸入多筆DropDownList元件，為True代表啟動，使用時需配合WebGridView中要貼入WebDropDownList元件才能正常運作。
AutoPostBackWebGridTextBoxs(多個控制項)(bool)
此專門用來配合一次可以直接在ItemTemplate中輸入多筆TextBox元件，為True代表啟動，使用時需配合WebGridView中要貼入WebGridTextBox元件才能正常運作。
MultiCheckColumn(控制項欄位名稱)(string)
此配合AutoPostBackMultiCheckBoxes=True時使用，須配合定義本屬性要搭配的欄位名稱，本欄位只能是Bit型態的欄位。
Params ( 參數 ) (Collection)
此 屬性可設定哪些 參數需要在 EditURL 中的 WebTranslate 保存 後保留下 來， 只要在 Params 中增加 一項 參數 "Filter"( 過濾條件 ) 就可以 記下 查詢條件
EditURLPanel ( 編輯鏈接的 ModalPanel )(string)
用於 設定關聯 對應的 AjaxModalPanel ，讓 WebGridView 在 Insert/Update/View 時可以 將此 AjaxModalPanel 打開，並以 ShowModal 方式呈現。
【功能函數】
ToExcel () ：依照 WebGridView 內的 Control 來輸出 , 只要Control 內有 text 的屬性的資料都可以輸出到 Excel中 , 並按 WebGridView 的欄位次序輸出。
【 事件 】
Adding(EventArgs e)
用於 控制新增 Button 按下 後，要配合 執行的功能， Adding 則是指新增前。
Added( EventArgs e)
用於 控制 OK Button 按下 後，要配合 執行的功能， Added 則是指新增 後。
【其它說明】
1. 如果要刪除WebGridView中的ExpressionField，必須先在Fields屬性中刪除此ExpressionField，再將ExpressionFieldCount屬性的值減去相應已刪除ExpressionField的數量即可。
2. WebGridView的設計模式中，可以用右鍵的AdjustColumn功能，自動以COLDEF的Field_Length來自動決定其相對欄位的寬度(全部調整HeaderStyle.Width，並以百分比來調整)，如果當 field_length沒有設定時，則Varchar都當作20，數值與其他都當作10來計算，再用此Width除以總寬度(所有欄位的總計)，得到百分比。
3. WebGridView在設計模式中，可以用右鍵'Copy AddNewControls'功能，自動將FooterTemplate內的元件Copy進去WebGridView的AddNewControls中，這是為了讓開發者方便自動Copy 有設TemplateField的欄位，自動將其FooterTemplate的元件Copy到AddNewControls中，以簡化設計。
4. 請注意，TotalCaption屬性一定要配合第一個WebGridView的Column要不為Binding的欄位，否則無法顯示出TotalCaption在Footer中。
5. WebGridView 在 EditURL 方式中實現連續新增，目前方法為 : 在Formview 上貼一個" 繼續新增 " 的 Button ，執行以下程式即可 :
FormView.InsertItem ( false);
FormView.ChangeMode ( FormViewMode.Insert );
【 範例 】
利用 RowDataBound 的事件來設定欄位的初值， 如下 :
protected voidWebGridView1_RowDataBound( objectsender, GridViewRowEventArgse)
{
// 做 Default 操作 (Insert時使用 )
if (e.Row.RowType == DataControlRowType.Footer && WebGridView1.ShowFooter)
{
Control ctrl = e.Row.FindControl( "TextBox1");
if (ctrl != null&& ctrl is TextBox)
{
TextBoxtxt = ( TextBox)ctrl;
txt.Text = "abc";
}
}
// 做 Default 操作 (Update時使用 )
if (e.Row.RowType == DataControlRowType.DataRow)
{
Control ctrl = e.Row.FindControl( "TextBox1");
if (ctrl != null&& ctrl is TextBox)
{
TextBoxtxt = ( TextBox)ctrl;
txt.Text = "abc";
}
}
}
可以利用 RowUpdating 的事件來設定更改時欄位的檢核， 如下 :
在 RowUpdating 事件中 , 加入如下代码
protected voidwgvDetail_RowUpdating( objectsender, GridViewUpdateEventArgse)
{
if (e.NewValues[ "UnitPrice"].ToString() == "0") // 此為沒有 Template 的欄位
{
e.Cancel = true;
Page.Response.Write( "<script>alert('UnitPrice 必須不为 0 !');</script>" );
return ;
}
// 如果有設為 TemplateField 者 , 則改用 FindControl
WebRefVal rf = ( WebRefVal)wgvDetail.Rows[e.RowIndex].FindControl( "wrvOrderDetailsProductIDE");
if (rf.BindingValue[0] >= '0'&& rf.BindingValue[0]<= '9')
{
e.Cancel = true;
Page.Response.Write( "<script>alert('Product ID 第一個字母不為數字 !');</script>" );
}
}
可以利用 Inserting 的事件來設定新增時欄位的檢核， 如下 :
protected voidWebGridView1_Inserting( objectsender, EventArgse)
{
if (WebGridView1.ShowFooter)
{
Controlctrl = WebGridView1.FooterRow.FindControl( "TextBox1");
if(ctrl != null&& ctrl is TextBox)
{
TextBoxtxt = ( TextBox)ctrl;
if(txt.Text == null|| txt.Text == "")
{
Page.Response.Write( "<script>alert(' 请输入不为空的 groupname 的值 !');</script>" );
WebGridView1.SkipInsert = true; // 这行一定要写
}
}
}
}
| Converted from CHM to HTML with chm2web Pro 2.85 (unicode) |