ASP.NET CustomValidator 컨트롤

정의와 사용법

CustomValidator 컨트롤은 입력 컨트롤에 대해 사용자 정의 검증을 수행할 수 있습니다。

속성

속성 설명
BackColor CustomValidator 컨트롤의 배경색.
ClientValidationFunction

검증을 위해 사용되는 사용자 정의 클라이언트 스크립트 함수의 이름을 정의합니다。

주의事项: 스크립트는 브라우저가 지원하는 언어로 작성되어야 합니다. 예를 들어 VBScript나 JScript

VBScript를 사용하면, 함수는 양식 내에 위치해야 합니다:

Sub FunctionName (source, arguments)

JScript를 사용하면, 함수는 양식 내에 위치해야 합니다:

Function FunctionName (source, arguments)

ControlToValidate 검증할 입력 컨트롤의 id.
Display

검증 컨트롤에서 오류 메시지 표시 행동.

허용된 값은 다음과 같습니다:

  • None - 검증 메시지는 내장되지 않습니다.
  • Static - 페이지 레이아웃에서 검증 메시지를 표시하기 위해 공간을 할당합니다.
  • Dynamic - 검증 실패 시 검증 메시지를 표시하기 위해 페이지에 동적으로 공간을 추가합니다.
EnableClientScript 부울 값, 이 값은 클라이언트 측 검증을 활성화했는지를 나타냅니다.
Enabled 부울 값, 이 값은 검증 컨트롤을 활성화했는지를 나타냅니다.
ErrorMessage

검증 실패 시 ValidationSummary 컨트롤에서 표시되는 오류 메시지 텍스트.

주의: ErrorMessage 속성이 설정되었지만 Text 속성이 설정되지 않았을 경우, 검증 컨트롤에서 ErrorMessage 속성의 값도 표시됩니다.

ForeColor 컨트롤의 전경색.
id 컨트롤의 유일한 id.
IsValid 부울 값, 이 값은 관련 입력 컨트롤이 검증을 통과했는지를 나타냅니다.
OnServerValidate 서버 측 검증 스크립트 함수 이름을 정의합니다.
runat 이 컨트롤이 서버 컨트롤인지 정의합니다. "server"로 설정해야 합니다.
텍스트 검증 실패 시 표시되는 텍스트.

예제

CustomValidator
이 예제에서는 .aspx 파일에서 두 개의 Label 컨트롤, 하나의 TextBox 컨트롤, 하나의 Button 컨트롤 및 하나의 CustomValidator 컨트롤을 선언했습니다. user() 함수는 입력 값을 검사합니다. 입력 값의 길이가 8보다 작거나 16보다 크면 CustomValidator 컨트롤에서 "사용자 이름은 8에서 16자 사이여야 합니다!"라는 텍스트를 표시합니다.