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 tra ở 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ó NOT NULL, CHECK của khoá SQL làm chốt chặn cuối.

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 tra.
• 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 tra ở 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 tra ở 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 tra ở form để báo sớm, database vẫn giữ ràng buộc làm chốt cuối.