本教程介紹DevExpress WinForm的Data Grid控件是如何利用網格組件完成數據輸入驗證的。

P.S：DevExpress WinForms擁有180+組件和UI庫，能為Windows Forms平臺創建具有影響力的業務解決方案。DevExpress WinForms能完美構建流暢、美觀且易于使用的應用程序，無論是Office風格的界面，還是分析處理大批量的業務數據，它都能輕松勝任！

獲取DevExpress WinForms v24.1正式版下載

DevExpress技術交流群10：532598169      歡迎一起進群討論

默認數據驗證

默認情況下，DevExpress WinForm網格控件啟用了內置數據類型驗證。如果在綁定到數字數據字段的列中輸入字符串值，然后按ENTER鍵或嘗試將焦點從單元格移開，則網格將驗證數據輸入并引發錯誤，因為字符串無法轉換為數字值。將鼠標懸停在錯誤圖標上，可以看到相同的錯誤消息。

更正輸入的值或放棄更改來繼續使用網格控件，要取消更改，請按ESCAPE。

修改默認錯誤信息

要手動指定默認錯誤消息，請執行以下操作。

1. 處理視圖的事件。

2. 在事件處理程序中，使用屬性檢查焦點列。

3. 嘗試將事件的參數轉換為所需的類型。

4. 如果該值不能轉換，將參數設置為false，并指定自定義的屬性值。

C#

private void gridView1_ValidatingEditor(object sender, BaseContainerValidateEditorEventArgs e) {
GridView view = sender as GridView;
if (view.FocusedColumn.FieldName == "UnitPrice") {
double price = 0;
if (!Double.TryParse(e.Value as String, out price)) {
e.Valid = false;
e.ErrorText = "Only numeric values are accepted.";
}
}
}

運行應用程序，看看驗證機制現在是如何顯示自定義的錯誤消息的。

提供自定義數據驗證規則

要驗證數據，請執行以下操作：

1. 處理相同的事件。

2. 若要在特定列中只允許正數值，請檢查轉換值是否大于0。

3. 如果不是，將 參數設置為false并指定您的自定義錯誤消息。

C#

private void gridView1_ValidatingEditor(object sender, BaseContainerValidateEditorEventArgs e) {
GridView view = sender as GridView;
if (view.FocusedColumn.FieldName == "UnitPrice") {
double price = 0;
if (!Double.TryParse(e.Value as String, out price)) {
e.Valid = false;
e.ErrorText = "Only numeric values are accepted.";
}
else if (price <= 0) {
e.Valid = false;
e.ErrorText = "The unit price must be positive.";
}
}
}

如果運行該應用程序，將看到在嘗試向單元格中輸入零時出現指定的錯誤消息。

顯示“異常消息框”

要自定義顯示錯誤的方式，請執行以下操作。

1. 處理視圖的事件。

2. 在事件處理程序中，顯示帶有屬性值的消息框。

3. 要禁用默認的錯誤圖標和工具提示，請將參數設置為。

C#

private void gridView1_InvalidValueException(object sender, InvalidValueExceptionEventArgs e) {
MessageBox.Show(this, e.ErrorText, "Invalid Value", MessageBoxButtons.OK, MessageBoxIcon.Error);
e.ExceptionMode = ExceptionMode.NoAction;
}

DevExpress WinForms網格控件現在使用消息框通知您有關錯誤的信息。

啟用行驗證

如果一個值的有效性取決于同一行中的其他值，則可以通過處理事件啟用行驗證。

例如，確保一列中的值大于另一列中的值。

1. 在ValidateRow事件處理程序中，獲取所需的列對象。
2. 使用視圖的方法來確定聚焦行中的列值。
3. 檢查其中一個值是否大于另一個值。
4. 使用方法將錯誤消息設置為列單元格，使用列對象作為第一個參數，使用錯誤消息字符串作為第二個參數。
5. 若要將錯誤分配給整個行，請調用方法，并將第一個參數設置為null。
6. 將事件的 參數設置為false，并將設置為自定義錯誤消息。

C#

private void gridView1_ValidateRow(object sender, DevExpress.XtraGrid.Views.Base.ValidateRowEventArgs e) {
GridView view = sender as GridView;
GridColumn colUnitsInStock = view.Columns["UnitsInStock"];
GridColumn colUnitsOnOrder = view.Columns["UnitsOnOrder"];

double unitsInStock = Convert.ToDouble(view.GetRowCellValue(view.FocusedRowHandle, colUnitsInStock));
double unitsOnOrder = Convert.ToDouble(view.GetRowCellValue(view.FocusedRowHandle, colUnitsOnOrder));
if (unitsInStock < unitsOnOrder) {
view.SetColumnError(colUnitsInStock, "The Units On Order value should be less than this value.");
view.SetColumnError(colUnitsOnOrder, "This value should be less than the Units In Stock value.");
view.SetColumnError(null, "Invalid data");
e.Valid = false;
e.ErrorText = "'Units On Order' and 'Units In Stock' values are not consistent.";
}
}

運行應用程序，輸入無效值并嘗試將焦點切換到另一行。此時將進行行驗證，并調用帶有指定錯誤文本的默認錯誤對話框。

單擊Yes，然后將鼠標懸停在錯誤圖標上，來查看為各個列指定的錯誤消息。

禁用默認錯誤信息框

要在驗證行時禁用默認對話框窗口，請處理事件并將參數設置為。

C#

private void gridView1_InvalidRowException(object sender, DevExpress.XtraGrid.Views.Base.InvalidRowExceptionEventArgs e) {
e.ExceptionMode = ExceptionMode.NoAction;
}

現在當輸入不正確的值時，消息將被抑制，但是您仍然可以在數據單元格和行指示符區域中看到相同的錯誤圖標。

更多產品資訊及授權，歡迎“”！