MaskedTextBox.Mask 속성

  • 참조

정의

네임스페이스:
System.Windows.Forms
어셈블리:
System.Windows.Forms.dll

런타임에 사용할 입력 마스크를 가져오거나 설정합니다.

public:
 property System::String ^ Mask { System::String ^ get(); void set(System::String ^ value); };
public string Mask { get; set; }
member this.Mask : string with get, set
Public Property Mask As String

속성 값

String

현재 마스크를 나타내는 String입니다. 기본값은 모든 입력을 허용하는 빈 문자열입니다.

예외

ArgumentException

Mask 속성에 제공된 문자열이 올바른 마스크가 아닌 경우. 잘못된 마스크에는 인쇄할 수 없는 문자가 들어 있는 마스크가 포함됩니다.

설명

Mask 에 대 한 기본 속성을 MaskedTextBox 클래스입니다.

Mask 는 다음 표와 같이 하나 이상의 마스킹 요소로 구성된 문자열이어야 합니다. 에서 MaskedTextBox 사용하는 마스킹 언어는 연결된 에 의해 정의됩니다 MaskedTextProvider. 표준 공급자는 Visual Basic 6.0의 마스킹된 편집 컨트롤에서 사용하는 언어를 기반으로 마스킹 언어를 지정하며 해당 플랫폼에서 마이그레이션하는 사용자에게 매우 익숙해야 합니다.

마스킹 요소 설명
0 숫자, 필수 요소입니다. 이 요소는 0에서 9 사이의 한 자릿수를 허용합니다.
9 숫자 또는 공백(선택 사항)입니다.
# 숫자 또는 공백(선택 사항)입니다. 이 위치가 마스크에 비어 있으면 속성의 Text 공백으로 렌더링됩니다. 더하기(+) 및 빼기(-) 기호가 허용됩니다.
L 문자, 필수. 입력을 ASCII 문자 a-z 및 A-Z로 제한합니다. 이 mask 요소는 정규식의 [a-zA-Z]와 동일합니다.
? 문자, 선택 사항. 입력을 ASCII 문자 a-z 및 A-Z로 제한합니다. 이 mask 요소는 [a-zA-Z]와 동일합니까? 정규식에 있습니다.
& 문자, 필수. 속성이 AsciiOnly true로 설정된 경우 이 요소는 "L" 요소처럼 동작합니다.
C 문자, 선택 사항. 제어할 수 없는 문자입니다. 속성이 AsciiOnly 로 설정된 true경우 이 요소는 "?" 요소처럼 동작합니다.
A 영숫자, 필수. 속성이 AsciiOnly 로 true설정된 경우 수락할 문자는 ASCII 문자 a-z 및 A-Z뿐입니다. 이 mask 요소는 "a" 요소처럼 동작합니다.
a 영숫자, 선택 사항. 속성이 AsciiOnly 로 true설정된 경우 수락할 문자는 ASCII 문자 a-z 및 A-Z뿐입니다. 이 mask 요소는 "A" 요소처럼 동작합니다.
. 소수 자리 표시자입니다. 사용되는 실제 표시 문자는 컨트롤의 속성에 따라 결정되는 형식 공급자에 적합한 10진수 기호입니다 FormatProvider .
, 수천 자리 표시자. 사용된 실제 표시 문자는 컨트롤의 속성에 따라 결정되는 형식 공급자에 적합한 수천 자리 표시자입니다 FormatProvider .
: 시간 구분 기호. 사용된 실제 표시 문자는 컨트롤의 속성에 따라 결정되는 형식 공급자에 적합한 시간 기호입니다 FormatProvider .
/ 날짜 구분 기호. 사용된 실제 표시 문자는 컨트롤의 속성에 따라 결정되는 형식 공급자에 적합한 날짜 기호가 FormatProvider 됩니다.
$ 통화 기호입니다. 표시된 실제 문자는 컨트롤의 속성에 따라 결정되는 형식 공급자에 적합한 통화 기호입니다 FormatProvider .
< 아래로 이동합니다. 뒤에 있는 모든 문자를 소문자로 변환합니다.
> 위로 이동합니다. 뒤에 있는 모든 문자를 대문자로 변환합니다.
| 이전 교대 근무를 사용하지 않도록 설정하거나 아래로 이동합니다.
\ 탈출. 마스크 문자를 이스케이프하여 리터럴로 변환합니다. "\\"는 백슬래시에 대한 이스케이프 시퀀스입니다.
다른 모든 문자 리터럴. 마스크가 아닌 모든 요소는 내에 MaskedTextBox자체로 표시됩니다. 리터럴은 항상 런타임에 마스크의 정적 위치를 차지하며 사용자가 이동하거나 삭제할 수 없습니다.

이전 마스크로 필터링된 사용자 입력이 이미 포함된 경우 마스크 MaskedTextBox 를 변경하는 경우 는 해당 입력을 새 마스크 MaskedTextBox 정의로 마이그레이션하려고 시도합니다. 실패하면 기존 입력을 지웁니다. 길이가 0인 문자열을 마스크로 할당하면 컨트롤의 기존 데이터가 유지됩니다. 길이가 0인 마스크와 함께 사용할 경우 는 MaskedTextBox 한 줄 TextBox 컨트롤처럼 동작합니다.

소수점 (.), 1/1000 (,), 시간 (:), (/), 날짜 및 통화 ($) 기호 기본 애플리케이션의 문화권에서 정의 된 대로 해당 기호를 표시 합니다. 속성을 사용하여 FormatProvider 다른 문화권에 대한 기호를 표시하도록 강제할 수 있습니다.

런타임에 마스크에 문자 삽입은 속성에 의해 InsertKeyMode 제어됩니다. 사용자는 왼쪽 및 오른쪽 화살표 키 또는 마우스 커서를 사용하여 마스크를 탐색할 수 있으며 공백을 입력하여 마스크의 선택적 위치를 건너뛸 수 있습니다.

중요

MaskedTextBox 는 서로게이트 및 세로로 결합된 문자를 제외한 모든 유니코드 문자를 지원합니다.

다음 표에서는 예제 마스크를 보여 줍니다.

Mask 동작
00/00/0000 국제 날짜 형식의 날짜(일, 숫자 월, 연도)입니다. "/" 문자를 논리적 날짜 구분 기호 이며 사용자에 게 애플리케이션의 현재 문화권에 적합 한 날짜 구분 기호로 표시 됩니다.
00->L<LL-0000 날짜(일, 월 약어 및 연도)는 미국 형식으로, 3자 월 약어는 초기 대문자와 두 개의 소문자를 차례로 표시합니다.
(999)-000-0000 미국 전화 번호, 지역 번호 선택 사항입니다. 사용자가 선택적 문자를 입력하지 않으려는 경우 공백을 입력하거나 마우스 포인터를 처음 0이 나타내는 마스크의 위치에 직접 배치할 수 있습니다.
$999,999.00 0에서 999999 범위의 통화 값입니다. 통화, 천 번째 및 10진수 문자는 런타임에 문화권별 해당 문자로 바뀝니다.

적용 대상

추가 정보