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진수 문자는 런타임에 문화권별 해당 문자로 바뀝니다.

추가 정보

• Text
• MaskFull
• MaskCompleted
• MaskChanged
• MaskedTextProvider