کنترل ASP.NET RangeValidator
تعریف و استفاده
کنترل RangeValidator برای بررسی اینکه آیا مقدار ورودی کاربر بین دو مقدار بین آنها قرار دارد یا خیر، استفاده می‌شود. می‌توان از آن برای مقایسه انواع مختلف داده‌ها مانند اعداد، تاریخ‌ها و کاراکترها استفاده کرد.
نکته:اگر کنترل ورودی خالی باشد، تأیید شکست نخواهد خورد. از کنترل RequiredFieldValidator استفاده کنید تا این فیلد به عنوان یک فیلد اجباری درآید.
نکته:اگر مقدار ورودی قابل تبدیل به نوع داده مشخص شده نباشد، تأیید نیز شکست نخواهد خورد. از کنترل CompareValidator استفاده کنید و ویژگی Operator آن را به ValidationCompareOperator.DataTypeCheck تنظیم کنید تا بتوانید نوع داده ورودی را تأیید کنید.
ویژگی
| ویژگی | توضیح |
|---|---|
| BackColor | رنگ پس‌زمینه کنترل RangeValidator |
| ControlToValidate | id کنترل‌های تأییدی که باید تأیید شوند |
| Display |
رفتار نمایش کنترل‌های تأیید. ارزش‌های مجاز عبارتند از:
|
| EnableClientScript | بولین، تعیین می‌کند که آیا تأیید کاربران در سرور فعال است یا خیر. |
| Enabled | بولین، تعیین می‌کند که آیا کنترل‌های تأیید فعال هستند یا خیر. |
| ErrorMessage |
متن نمایش داده شده در ValidationSummary کنترل در صورت شکست تأیید. توضیح: اگر Property Text تنظیم نشده باشد، متن نیز در این کنترل تأیید نمایش داده می‌شود. |
| ForeColor | رنگ پیش‌زمینه این کنترل. |
| id | id منحصر به فرد کنترل. |
| IsValid | 布尔، نشان‌دهنده این که کنترل ورودی مرتبط با آن آیا تأیید شده است یا خیر. |
| MaximumValue | تعیین حداکثر مقدار کنترل ورودی. |
| MinimumValue | تعیین حداقل مقدار کنترل ورودی. |
| runat | تعیین اینکه این کنترل یک کنترل سرور است. باید به "server" تنظیم شود. |
| Type |
تعیین نوع داده‌ای که باید بررسی شود. نوع‌ها عبارتند از:
|
| Text | پیام نمایش داده شده در صورت شکست تأیید |
مثال
- RangeValidator
- در این مثال، ما یک کنترل TextBox، یک کنترل Button و یک کنترل RangeValidator در فایل .aspx اعلام کرده‌ایم. اگر تأیید نشود، متن "The date must be between 1/1/2002 and 31/5/2002!" در کنترل RangeValidator نمایش داده می‌شود.
- RangeValidator 2
- در این مثال، ما یک کنترل TextBox، یک کنترل Button، یک کنترل Label و یک کنترل RangeValidator در فایل .aspx اعلام کرده‌ایم. تابع submit() می‌تواند بررسی کند که صفحه‌ی وب معتبر است یا خیر. اگر معتبر باشد، متن "The page is valid!" در کنترل Label نمایش داده می‌شود. اگر معتبر نباشد، متن "The page is not valid!" در کنترل Label نمایش داده می‌شود. اگر تأیید نشود، متن "The value must be from 1 to 100!" در کنترل RangeValidator نمایش داده می‌شود.
