کنترل CustomValidator ASP.NET

تعریف و استفاده

کنترل CustomValidator می‌تواند ورودی‌های کنترل را با تأیید تعریف شده توسط کاربر بررسی کند.

ویژگی

ویژگی توضیح
BackColor رنگ پس‌زمینه کنترل CustomValidator
ClientValidationFunction

نام تابع‌های اسکریپت مشتری‌ای که برای تأیید استفاده می‌شود را تعیین می‌کند.

توضیح: اسکریپت باید به زبانی که مرورگر پشتیبانی می‌کند، نوشته شود، مانند VBScript یا JScript

اگر از VBScript استفاده کنید، باید تابع در فرم قرار گیرد:

Sub FunctionName (source, arguments)

اگر از JScript استفاده کنید، باید تابع در فرم قرار گیرد:

Function FunctionName (source, arguments)

ControlToValidate id کنترل ورودی که باید ارزیابی شود.
Display

رفتار نمایش اطلاعیه خطا در کنترل ارزیابی.

مقدارهای مجاز عبارتند از:

  • None - پیام ارزیابی هرگز به صورت درون‌صفحه نمایش داده نمی‌شود.
  • Static - فضایی که برای نمایش پیام ارزیابی در طرح صفحه اختصاص داده شده.
  • Dynamic - اگر ارزیابی شکست بخورد، فضای برای نمایش پیام ارزیابی به صورت پویا به صفحه اضافه می‌شود.
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 نمایش داده می‌شود.