کنترل ErrorProvider در سی شارپ

کنترل ErrorProvider در سی شارپ

کنترل ErrorProvider در سی‌شارپ یکی از ابزارهای مفید برای اعتبارسنجی ورودی کاربران در برنامه‌های WinForms است.

این کنترل به شما امکان می‌دهد تا هنگام ورود اطلاعات نادرست یا ناقص توسط کاربر، پیامی هشداردهنده در کنار فیلد مربوطه (مانند TextBox یا ComboBox) نمایش دهید.

ErrorProvider به جای نمایش پیغام در پنجره مجزا، از یک آیکون کوچک قرمز رنگ کنار کنترل استفاده می‌کند که با نگه داشتن ماوس روی آن، پیام خطا قابل مشاهده خواهد بود.

استفاده از ErrorProvider بسیار ساده است و کافی است در رویدادهای مربوط به اعتبارسنجی (مثل Validating) بررسی‌های لازم را انجام داده و در صورت نیاز، با استفاده از متد SetError پیام خطا را تنظیم کنید.

همچنین با متد Clear می‌توانید خطاها را پاک کرده و وضعیت ورودی را نرمال کنید.

این کنترل برای بهبود تجربه کاربری و جلوگیری از ارسال داده‌های نادرست بسیار کاربردی و حرفه‌ای است.

ویژگی‌های اصلی ErrorProvider در سی شارپ

• آیکون‌های خطا

  خطاها به‌طور خودکار با استفاده از یک آیکون مشخص (مثلث زرد یا دایره قرمز) نمایش داده می‌شوند.

• نمایش پیغام‌ها

  می‌توان پیغام‌های مربوط به خطا را به‌طور مستقیم به کنترل‌ها نسبت داد.

• زمان‌بندی نمایش

  می‌توان مشخص کرد که پیغام‌های خطا تا چه زمانی نمایش داده شوند و در صورت لزوم، از آن‌ها حذف شوند.

• چندگانه بودن خطاها

  می‌توان چندین خطا را به طور همزمان برای کنترل‌های مختلف در فرم مدیریت کرد.

ایجاد ErrorProvider در فرم

برای استفاده از ErrorProvider در سی شارپ، ابتدا باید این کنترل را به فرم خود اضافه کرده و سپس آن را به فیلدهای ورودی متصل کنید.

این کار به سادگی قابل انجام است و در ادامه نحوه انجام آن را توضیح خواهیم داد.

• ایجاد پروژه جدید Windows Forms

  ابتدا در Visual Studio یک پروژه جدید از نوع Windows Forms Application ایجاد کنید.
  در این پروژه باید یک فرم طراحی شده داشته باشید که در آن از ErrorProvider استفاده می‌کنید.

• اضافه کردن ErrorProvider به فرم

  برای اضافه کردن ErrorProvider به فرم، مراحل زیر را دنبال کنید:

در پنل Toolbox در Visual Studio، به دنبال کنترل ErrorProvider بگردید.

ErrorProvider را به فرم خود بکشید و در مکان دلخواه قرار دهید.

پس از اضافه کردن ErrorProvider به فرم، این کنترل به‌صورت یک آیکون کوچک در گوشه پایین سمت راست فرم ظاهر می‌شود.
این آیکون نشان‌دهنده وضعیت نمایش خطا است.

• اتصال ErrorProvider به کنترل‌های ورودی

  برای نمایش خطاها در کنار کنترل‌های ورودی، باید پیغام‌های خطا را به این کنترل‌ها نسبت دهید.
  برای انجام این کار، از متد SetError استفاده می‌کنیم که به‌صورت زیر عمل می‌کند:

using System;
using System.Windows.Forms;

namespace ErrorProviderExample
{
    public partial class MainForm : Form
    {
        public MainForm()
        {
            InitializeComponent();
        }

        private void buttonSubmit_Click(object sender, EventArgs e)
        {
            // اعتبارسنجی ورودی‌ها
            if (string.IsNullOrEmpty(textBoxName.Text))
            {
                errorProvider.SetError(textBoxName, "نام نمی‌تواند خالی باشد.");
            }
            else
            {
                errorProvider.SetError(textBoxName, string.Empty);  // پاک کردن خطا
            }

            if (string.IsNullOrEmpty(textBoxEmail.Text))
            {
                errorProvider.SetError(textBoxEmail, "ایمیل نمی‌تواند خالی باشد.");
            }
            else
            {
                errorProvider.SetError(textBoxEmail, string.Empty);  // پاک کردن خطا
            }
        }
    }
}

توضیحات کد:

در این کد، دو TextBox برای وارد کردن نام و ایمیل داریم.

هنگامی که کاربر دکمه Submit را می‌زند، ابتدا ورودی‌ها اعتبارسنجی می‌شوند.

اگر ورودی نام یا ایمیل خالی باشد، پیام خطا در کنار آن ورودی نمایش داده می‌شود.

اگر ورودی‌ها معتبر باشند، خطا از کنار فیلد حذف می‌شود.

 

آیا به دنبال یک فرصت عالی برای یادگیری برنامه‌نویسی هستید؟ 🚀

با دوره آموزشی سی‌شارپ ما، شما می‌توانید مهارت‌های خود را به سطح جدیدی ارتقا دهید! این دوره به‌طور کامل طراحی شده تا به شما کمک کند تا از مبتدی تا پیشرفته در دنیای برنامه‌نویسی سی‌شارپ پیش بروید.

👨‍🏫 چرا دوره ما را انتخاب کنید؟

• محتوای جامع و عملی: با پروژه‌های واقعی و تمرینات عملی، یادگیری را به تجربه‌ای جذاب تبدیل کنید.
• مدرس مجرب: از تجربه و دانش مدرس حرفه‌ای بهره‌مند شوید که شما را در هر مرحله از یادگیری راهنمایی می‌کنند.
• پشتیبانی ۲۴/۷: هر زمان که سوالی داشتید، ما در کنار شما خواهیم بود تا به شما کمک کنیم.
• دسترسی مادام‌العمر: به محتوای دوره دسترسی دائمی داشته باشید و هر زمان که خواستید، می‌توانید به آن مراجعه کنید.

💡 فرصت را از دست ندهید!

بایادگیری سی‌شارپ، می‌توانید در دنیای فناوری اطلاعات به یک متخصص تبدیل شوید و در پروژه‌های جذاب و چالش‌برانگیز شرکت کنید.

همین امروز به جمع یادگیرندگان ما بپیوندید و اولین قدم را به سوی آینده‌ای روشن‌تر بردارید!

شرکت در دوره آموزش برنامه نویسی سی شارپ

 

مثال از ویژگی‌ها و روش‌های استفاده از ErrorProvider

•  SetError

  متد SetError به شما این امکان را می‌دهد که پیغام خطا را برای یک کنترل خاص نمایش دهید یا آن را پاک کنید. این متد دو پارامتر دارد:
  • کنترل: کنترل ورودی که می‌خواهید خطا را برای آن نمایش دهید.
  • پیغام خطا: پیغام خطای مربوطه یا یک رشته خالی برای پاک کردن خطا.

errorProvider.SetError(textBoxName, "نام نمی‌تواند خالی باشد.");

برای پاک کردن پیغام خطا، می‌توانید از رشته خالی استفاده کنید:

errorProvider.SetError(textBoxName, string.Empty);

• Clear

  متد Clear برای حذف تمامی پیام‌های خطا از تمام کنترل‌های فرم استفاده می‌شود.
  این متد می‌تواند زمانی مفید باشد که بخواهید تمامی پیام‌های خطا را به‌طور همزمان پاک کنید.

errorProvider.Clear();

• RightToLeft

  ویژگی RightToLeft برای تعیین این است که پیام‌های خطا از راست به چپ نمایش داده شوند یا از چپ به راست.
  این ویژگی به‌ویژه در برنامه‌هایی که از زبان‌های راست به چپ استفاده می‌کنند، مانند زبان فارسی یا عربی، کاربرد دارد.

errorProvider.RightToLeft = RightToLeft.Yes;

• IconAlignment

  ویژگی IconAlignment تعیین می‌کند که آیکون خطا در کجا نمایش داده شود.
  این ویژگی می‌تواند به شما کمک کند تا تعیین کنید آیکون خطا در سمت راست یا چپ کنترل ظاهر شود.

errorProvider.IconAlignment = ErrorIconAlignment.MiddleRight;

•  IconPadding

  ویژگی IconPadding به شما این امکان را می‌دهد که فاصله بین آیکون خطا و کنترل ورودی را تنظیم کنید.

errorProvider.IconPadding = 5;

کاربردهای ErrorProvider در سی شارپ

• اعتبارسنجی ورودی‌ها

  ErrorProvider برای اعتبارسنجی ورودی‌های فرم به‌طور گسترده‌ای استفاده می‌شود.
  به‌عنوان مثال، در فرم‌های ثبت‌نام یا ورود، می‌توان از این کنترل برای نمایش پیام‌های خطا در صورت عدم تکمیل صحیح فرم استفاده کرد.

• نمایش خطاهای اعتبارسنجی

  زمانی که ورودی‌های کاربر با قوانین خاصی (مانند فرمت ایمیل یا شماره تلفن) مطابقت نداشته باشند، از ErrorProvider برای نمایش خطا در کنار فیلدهای ورودی استفاده می‌شود.

• پیام‌های هشدار

  ErrorProvider می‌تواند برای نمایش پیام‌های هشدار یا اطلاعاتی که نیاز به توجه کاربران دارند، استفاده شود.
  این پیام‌ها معمولاً شامل آیکون‌های هشدار و پیام‌های مفید هستند.

• نمایش خطاهای سمت سرور

  در برنامه‌هایی که نیاز به ارسال داده‌ها به سرور دارند، ممکن است خطاهای سرور دریافت شوند.
  در این مواقع، می‌توان از ErrorProvider برای نمایش پیام‌های خطا در فرم استفاده کرد.

• افزایش تجربه کاربری

  نمایش خطاها و پیام‌های هشدار به شکلی واضح و غیرمداخله‌گر به کاربران، می‌تواند تجربه کاربری را بهبود بخشد و به آن‌ها کمک کند تا مشکلات ورودی را به راحتی تشخیص دهند و رفع کنند.