Kiểm tra dữ liệu nhập

Nhân viên có thể bấm "Lưu" khi chưa gõ tên, hoặc gõ giá bằng chữ. Bài này dùng ô nhập chỉ nhận số và báo lỗi ngay cạnh ô sai, trước khi dữ liệu đi tới database.

Khái niệm

🔢 NumericUpDown: ô nhập chỉ nhận số, giá trị đọc qua property Value kiểu decimal, giới hạn bởi Minimum và Maximum.

⚠️ ErrorProvider: component hiện biểu tượng lỗi cạnh một control, rê chuột vào biểu tượng thì thấy lời nhắn.

Dữ liệu sản phẩm được kiểm ở ba nơi. Form báo sớm cho người nhập. API có [Required], [Range] như bài Validation của khoá ASP.NET Core.

Database có ràng buộc như NOT NULL, CHECK ở bài CREATE TABLE và ràng buộc của khoá SQL, là chốt chặn cuối cùng.

Ví dụ

class MainForm : Form
{
    private readonly TextBox _nameBox =
        new TextBox { Width = 250 };
    private readonly NumericUpDown _priceBox =
        new NumericUpDown
        {
            Maximum = 100000000,
            Increment = 1000,
            Width = 250
        };
    private readonly ErrorProvider _errors =
        new ErrorProvider();

    public MainForm()
    {
        Text = "Thêm sản phẩm";

        var panel = new FlowLayoutPanel
        {
            Dock = DockStyle.Fill,
            FlowDirection = FlowDirection.TopDown,
            Padding = new Padding(12)
        };
        var saveButton = new Button { Text = "Lưu" };
        saveButton.Click += SaveButton_Click;

        panel.Controls.Add(_nameBox);
        panel.Controls.Add(_priceBox);
        panel.Controls.Add(saveButton);
        Controls.Add(panel);
    }

    private void SaveButton_Click(
        object? sender, EventArgs e)
    {
        _errors.Clear();
        if (_nameBox.Text.Trim() == "")
        {
            _errors.SetError(_nameBox, "Nhập tên");
            return;
        }
        if (_priceBox.Value <= 0)
        {
            _errors.SetError(_priceBox, "Giá phải > 0");
            return;
        }
        Text = $"Đã lưu {_nameBox.Text}";
    }
}

• NumericUpDown chặn phím chữ ngay khi gõ. Value là decimal, cùng kiểu với Price của Product.
• SetError(control, lời nhắn) hiện biểu tượng lỗi cạnh control đó. Clear() xoá mọi lỗi cũ trước mỗi lần kiểm.
• return dừng handler ngay ở lỗi đầu tiên, nên dữ liệu sai không bao giờ tới dòng lưu.

Thử ngay

Chạy app, để trống tên, giữ giá là 0, rồi bấm "Lưu". Sau đó gõ tên "Bút bi" và bấm "Lưu" lần nữa.

Đoán trước khi chạy: lần bấm đầu có mấy biểu tượng lỗi? Lần bấm thứ hai thì biểu tượng lỗi nằm ở đâu?

Lần 1: một biểu tượng lỗi, cạnh ô tên ("Nhập tên").
Lần 2: biểu tượng cạnh ô tên biến mất,
       một biểu tượng mới hiện cạnh ô giá ("Giá phải > 0").

Lỗi hay gặp

Quên đặt Maximum. NumericUpDown mặc định chỉ cho tối đa 100. Gõ giá 5000 rồi rời ô, giá tự bị kéo về 100 mà không báo gì.

// SAI — giá lớn hơn 100 bị kéo về 100
var priceBox = new NumericUpDown { Width = 250 };

// ĐÚNG — đặt giới hạn theo nghiệp vụ
var priceBox = new NumericUpDown
{
    Maximum = 100000000,
    Width = 250
};

Chỉ kiểm ở form. Đường ghi khác, như API hay một câu INSERT gõ tay, không đi qua form nên vẫn ghi được dữ liệu sai vào database. Kiểm ở form để báo sớm, còn ràng buộc trong database vẫn phải giữ.

Tóm tắt

• NumericUpDown cho nhập số, đọc bằng Value kiểu decimal.
• Luôn đặt Maximum, vì mặc định chỉ là 100.
• ErrorProvider.SetError báo lỗi cạnh control, Clear() xoá lỗi cũ.
• Kiểm ở form để báo sớm, database vẫn giữ ràng buộc làm chốt cuối.