کنترل CustomValidator ASP.NET
تعریف و استفاده
کنترل CustomValidator میتواند ورودیهای کنترل را با تأیید تعریف شده توسط کاربر بررسی کند.
ویژگی
ویژگی | توضیح |
---|---|
BackColor | رنگ پسزمینه کنترل CustomValidator |
ClientValidationFunction |
نام تابعهای اسکریپت مشتریای که برای تأیید استفاده میشود را تعیین میکند. توضیح: اسکریپت باید به زبانی که مرورگر پشتیبانی میکند، نوشته شود، مانند VBScript یا JScript اگر از VBScript استفاده کنید، باید تابع در فرم قرار گیرد: Sub FunctionName (source, arguments) اگر از JScript استفاده کنید، باید تابع در فرم قرار گیرد: Function FunctionName (source, arguments) |
ControlToValidate | id کنترل ورودی که باید ارزیابی شود. |
Display |
رفتار نمایش اطلاعیه خطا در کنترل ارزیابی. مقدارهای مجاز عبارتند از:
|
EnableClientScript | مقدار بولینی که نشاندهنده این است که ارزیابی کاربرنده (client) فعال است یا خیر. |
Enabled | مقدار بولینی که نشاندهنده این است که کنترل ارزیابی فعال است یا خیر. |
ErrorMessage |
متن اطلاعیه خطا در ValidationSummary کنترل در صورت شکست ارزیابی. توضیح: اگر属性 ErrorMessage تنظیم شده باشد اما属性 Text تنظیم نشده باشد، مقدار ErrorMessage نیز در کنترل ارزیابی نمایش داده میشود. |
ForeColor | رنگ پیشزمینه کنترل. |
id | id منحصر به فرد کنترل. |
IsValid | مقدار بولینی، که نشاندهنده این است که کنترل ورودی مرتبط آیا موفق به ارزیابی شده است یا خیر. |
OnServerValidate | نام تابع ارزیابی سرور端 انجام شده را مشخص میکند. |
runat | این کنترل باید کنترل سرور باشد. باید به "server" تنظیم شود. |
Text | متن نمایش داده شده در صورت شکست ارزیابی. |
مثال
- CustomValidator
- در این مثال، ما دو کنترل Label، یک کنترل TextBox، یک کنترل Button و یک کنترل CustomValidator در فایل .aspx اعلام کردهایم. تابع user() میتواند طول ورودی را بررسی کند. اگر طول کمتر از 8 یا بیشتر از 16 باشد، متن "نام کاربری باید بین 8 تا 16 کاراکتر باشد!" در کنترل CustomValidator نمایش داده میشود.