MaskedTextProvider 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
MaskedTextBox 컨트롤과 같이 마스킹을 지원하는 여러 컨트롤에서 사용할 수 있는 마스크 구문 분석 서비스를 나타냅니다.
public ref class MaskedTextProvider : ICloneablepublic class MaskedTextProvider : ICloneabletype MaskedTextProvider = class
interface ICloneablePublic Class MaskedTextProvider
Implements ICloneable- 상속
-
MaskedTextProvider
- 구현
설명
MaskedTextBox 컨트롤에는 모든 사용자 입력을 테스트하는 리터럴 문자 및 서식 지정 요소로 구성된 마스크가 포함되어 있습니다. Windows Forms는 특정 마스크 구문 분석 엔진을 MaskedTextBox영구적으로 연결하지 않고 Mask 속성 설명서에 설명된 마스킹 언어의 구문을 정의하는 MaskedTextProvider 클래스로 표현되는 별도의 서비스로 제공합니다.
MaskedTextBox 클래스의 많은 멤버는 연결된 MaskedTextProvider비슷하게 명명된 멤버에 대한 구현을 참조합니다. 예를 들어 MaskedTextBox 클래스의 MaskedTextBox.PromptChar 속성은 MaskedTextProvider 클래스의 PromptChar 대한 모든 액세스를 참조합니다.
MaskedTextProvider 사용하는 마스크 구문 분석 엔진은 Microsoft Visual Basic 버전 6에 포함된 마스크 편집 컨트롤을 모델로 합니다. 해당 마스킹 언어는 Mask 속성에 대한 설명서에 설명되어 있습니다.
다음 세 개의 고유 문자열은 MaskedTextProvider 클래스와 관련이 있습니다.
| 문자열 이름 | 묘사 |
|---|---|
| 입력 문자 또는 문자열 | 마스크가 적용되는 입력으로 사용되는 문자를 나타냅니다. 실제로 입력 문자열은 Add, Replace, InsertAt및 Remove포함하여 여러 입력 작업으로 구성될 수 있습니다. 따라서 입력 문자열에 직접 액세스할 수 없습니다. 그러나 입력 문자열 처리의 측면은 AllowPromptAsInput 및 AsciiOnly, ResetOnPrompt및 ResetOnSpace 속성을 통해 사용할 수 있습니다. |
| 마스크 | 입력 문자열을 형식이 지정된 문자열로 변환하는 데 사용되는 입력 서식 마스크를 나타냅니다. 이 문자열은 MaskedTextProvider 설정되며 주로 Mask 속성에 액세스합니다. 마스크의 특성은 Length, PasswordChar및 PromptChar 속성과 같은 다른 멤버를 통해서도 사용할 수 있습니다. |
| 서식이 지정된 문자열 | 전체 마스크가 입력 문자열에 적용될 때 발생하는 문자열을 나타냅니다. 형식이 지정된 문자열은 Item[], Length, LastAssignedPosition, MaskFull, MaskCompleted, FindEditPositionFrom등 클래스의 많은 멤버로 쿼리할 수 있습니다. 서식이 지정된 문자열의 전체 값은 ToDisplayString 및 ToString 메서드에서 사용할 수 있습니다. |
메모
입력 문자열은 MaskedTextBox경우와 같이 직접 사용자 입력을 나타내거나 사용자 입력/출력 작업과 직접 연결되지 않은 다른 프로세스에 의해 생성될 수 있습니다.
생성자
| MaskedTextProvider(String, Boolean) |
지정된 마스크 및 ASCII 제한 값을 사용하여 MaskedTextProvider 클래스의 새 인스턴스를 초기화합니다. |
| MaskedTextProvider(String, Char, Boolean) |
지정된 마스크, 암호 문자 및 프롬프트 사용 값을 사용하여 MaskedTextProvider 클래스의 새 인스턴스를 초기화합니다. |
| MaskedTextProvider(String, CultureInfo, Boolean, Char, Char, Boolean) |
지정된 마스크, 문화권, 프롬프트 사용량 값, 프롬프트 문자, 암호 문자 및 ASCII 제한 값을 사용하여 MaskedTextProvider 클래스의 새 인스턴스를 초기화합니다. |
| MaskedTextProvider(String, CultureInfo, Boolean) |
지정된 마스크, 문화권 및 ASCII 제한 값을 사용하여 MaskedTextProvider 클래스의 새 인스턴스를 초기화합니다. |
| MaskedTextProvider(String, CultureInfo, Char, Boolean) |
지정된 마스크, 문화권, 암호 문자 및 프롬프트 사용 값을 사용하여 MaskedTextProvider 클래스의 새 인스턴스를 초기화합니다. |
| MaskedTextProvider(String, CultureInfo) |
지정된 마스크 및 문화권을 사용하여 MaskedTextProvider 클래스의 새 인스턴스를 초기화합니다. |
| MaskedTextProvider(String) |
지정된 마스크를 사용하여 MaskedTextProvider 클래스의 새 인스턴스를 초기화합니다. |
속성
| AllowPromptAsInput |
프롬프트 문자를 유효한 입력 문자로 처리해야 하는지 여부를 나타내는 값을 가져옵니다. |
| AsciiOnly |
마스크가 ASCII 문자 집합 외부의 문자를 허용하는지 여부를 나타내는 값을 가져옵니다. |
| AssignedEditPositionCount |
입력 값이 이미 할당된 편집 가능한 문자 위치의 수를 가져옵니다. |
| AvailableEditPositionCount |
입력 값이 아직 할당되지 않은 입력 마스크의 편집 가능한 문자 위치 수를 가져옵니다. |
| Culture |
입력 마스크에서 지역화할 수 있는 구분 기호 및 자리 표시자의 값을 결정하는 문화권을 가져옵니다. |
| DefaultPasswordChar |
모호한 사용자 입력에 사용되는 기본 암호 문자를 가져옵니다. |
| EditPositionCount |
서식이 지정된 문자열의 편집 가능한 위치 수를 가져옵니다. |
| EditPositions |
서식이 지정된 문자열에서 편집 가능한 위치에 대해 새로 만든 열거자를 가져옵니다. |
| IncludeLiterals |
입력 마스크의 리터럴 문자를 서식이 지정된 문자열에 포함할지 여부를 나타내는 값을 가져오거나 설정합니다. |
| IncludePrompt |
서식이 지정된 문자열을 표시할 때 PromptChar 사용자 입력이 없음을 나타내는 데 사용되는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| InvalidIndex |
잘못된 인덱스 범위의 상한을 가져옵니다. |
| IsPassword |
형식이 지정된 문자열에 암호 보호를 적용해야 하는지 여부를 결정하는 값을 가져오거나 설정합니다. |
| Item[Int32] |
서식이 지정된 문자열의 지정된 위치에 있는 요소를 가져옵니다. |
| LastAssignedPosition |
마스크에 할당된 가장 오른쪽 입력 문자의 마스크에 있는 인덱스입니다. |
| Length |
마스크 한정자 문자가 없는 마스크의 길이를 가져옵니다. |
| Mask |
입력 마스크를 가져옵니다. |
| MaskCompleted |
모든 필수 입력이 형식이 지정된 문자열에 입력되었는지 여부를 나타내는 값을 가져옵니다. |
| MaskFull |
모든 필수 및 선택적 입력이 형식이 지정된 문자열에 입력되었는지 여부를 나타내는 값을 가져옵니다. |
| PasswordChar |
실제 입력 문자로 대체할 문자를 가져오거나 설정합니다. |
| PromptChar |
사용 가능한 모든 편집 위치에 대한 사용자 입력이 없음을 나타내는 데 사용되는 문자를 가져오거나 설정합니다. |
| ResetOnPrompt |
프롬프트 문자와 일치하는 입력 문자를 처리하는 방법을 결정하는 값을 가져오거나 설정합니다. |
| ResetOnSpace |
공백 입력 문자를 처리하는 방법을 결정하는 값을 가져오거나 설정합니다. |
| SkipLiterals |
마스크의 리터럴 문자 위치를 동일한 값으로 덮어쓸 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. |
메서드
| Add(Char, Int32, MaskedTextResultHint) |
지정된 입력 문자를 서식이 지정된 문자열의 끝에 추가한 다음 위치 및 설명 정보를 출력합니다. |
| Add(Char) |
서식이 지정된 문자열의 끝에 지정된 입력 문자를 추가합니다. |
| Add(String, Int32, MaskedTextResultHint) |
지정된 입력 문자열의 문자를 서식이 지정된 문자열의 끝에 추가한 다음 위치 및 설명 정보를 출력합니다. |
| Add(String) |
지정된 입력 문자열의 문자를 서식이 지정된 문자열의 끝에 추가합니다. |
| Clear() |
서식이 지정된 문자열에서 편집 가능한 입력 문자를 모두 지우고 프롬프트 문자로 바꿔줍니다. |
| Clear(MaskedTextResultHint) |
서식이 지정된 문자열에서 편집 가능한 입력 문자를 모두 지우고 프롬프트 문자로 바꾼 다음 설명이 포함된 정보를 출력합니다. |
| Clone() |
현재 MaskedTextProvider복사본을 만듭니다. |
| Equals(Object) |
지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object) |
| FindAssignedEditPositionFrom(Int32, Boolean) |
지정된 검색 방향을 사용하여 지정된 위치 다음에 할당된 첫 번째 편집 가능한 위치의 위치를 반환합니다. |
| FindAssignedEditPositionInRange(Int32, Int32, Boolean) |
지정한 검색 방향을 사용하여 지정된 위치 간에 첫 번째 할당된 편집 가능한 위치의 위치를 반환합니다. |
| FindEditPositionFrom(Int32, Boolean) |
지정한 검색 방향을 사용하여 지정한 위치 뒤의 첫 번째 편집 가능한 위치 위치를 반환합니다. |
| FindEditPositionInRange(Int32, Int32, Boolean) |
지정된 검색 방향을 사용하여 지정된 위치 사이의 첫 번째 편집 가능한 위치 위치를 반환합니다. |
| FindNonEditPositionFrom(Int32, Boolean) |
지정한 검색 방향을 사용하여 지정한 위치 다음에 편집할 수 없는 첫 번째 위치의 위치를 반환합니다. |
| FindNonEditPositionInRange(Int32, Int32, Boolean) |
지정한 검색 방향을 사용하여 지정한 위치 사이의 편집할 수 없는 첫 번째 위치의 위치를 반환합니다. |
| FindUnassignedEditPositionFrom(Int32, Boolean) |
지정한 검색 방향을 사용하여 지정한 위치 다음에 할당되지 않은 첫 번째 편집 가능한 위치의 위치를 반환합니다. |
| FindUnassignedEditPositionInRange(Int32, Int32, Boolean) |
지정된 검색 방향을 사용하여 지정된 위치 간에 할당되지 않은 첫 번째 편집 가능한 위치의 위치를 반환합니다. |
| GetHashCode() |
기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object) |
| GetOperationResultFromHint(MaskedTextResultHint) |
지정된 MaskedTextResultHint 성공 또는 실패를 나타내는지 여부를 결정합니다. |
| GetType() |
현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object) |
| InsertAt(Char, Int32, Int32, MaskedTextResultHint) |
지정한 문자를 서식이 지정된 문자열 내의 지정된 위치에 삽입하고 마지막 삽입 위치와 작업 상태를 반환합니다. |
| InsertAt(Char, Int32) |
서식이 지정된 문자열 내의 지정된 위치에 지정된 문자를 삽입합니다. |
| InsertAt(String, Int32, Int32, MaskedTextResultHint) |
지정한 문자열을 서식이 지정된 문자열 내의 지정된 위치에 삽입하고 마지막 삽입 위치와 작업 상태를 반환합니다. |
| InsertAt(String, Int32) |
서식이 지정된 문자열 내의 지정된 위치에 지정된 문자열을 삽입합니다. |
| IsAvailablePosition(Int32) |
지정한 위치를 할당할 수 있는지 여부를 결정합니다. |
| IsEditPosition(Int32) |
지정된 위치를 편집할 수 있는지 여부를 확인합니다. |
| IsValidInputChar(Char) |
지정된 문자가 유효한 입력 문자인지 여부를 확인합니다. |
| IsValidMaskChar(Char) |
지정된 문자가 유효한 마스크 문자인지 여부를 확인합니다. |
| IsValidPasswordChar(Char) |
지정된 문자가 유효한 암호 문자인지 여부를 확인합니다. |
| MemberwiseClone() |
현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| Remove() |
서식이 지정된 문자열에서 마지막으로 할당된 문자를 제거합니다. |
| Remove(Int32, MaskedTextResultHint) |
서식이 지정된 문자열에서 마지막으로 할당된 문자를 제거한 다음 제거 위치 및 설명 정보를 출력합니다. |
| RemoveAt(Int32, Int32, Int32, MaskedTextResultHint) |
서식이 지정된 문자열에서 지정된 위치 사이에 할당된 문자를 제거한 다음 제거 위치와 설명 정보를 출력합니다. |
| RemoveAt(Int32, Int32) |
서식이 지정된 문자열에서 지정된 위치 사이에 할당된 문자를 제거합니다. |
| RemoveAt(Int32) |
서식이 지정된 문자열에서 지정된 위치에 있는 할당된 문자를 제거합니다. |
| Replace(Char, Int32, Int32, Int32, MaskedTextResultHint) |
지정된 시작 위치와 끝 위치 사이의 단일 문자를 지정된 문자 값으로 바꾼 다음 제거 위치와 설명 정보를 출력합니다. |
| Replace(Char, Int32, Int32, MaskedTextResultHint) |
지정된 위치 또는 그 너머의 단일 문자를 지정된 문자 값으로 바꾼 다음 제거 위치 및 설명 정보를 출력합니다. |
| Replace(Char, Int32) |
지정된 위치 또는 그 너머의 단일 문자를 지정된 문자 값으로 바꿉니다. |
| Replace(String, Int32, Int32, Int32, MaskedTextResultHint) |
지정한 시작 위치와 끝 위치 사이의 편집 가능한 문자 범위를 지정된 문자열로 바꾼 다음 제거 위치와 설명 정보를 출력합니다. |
| Replace(String, Int32, Int32, MaskedTextResultHint) |
지정된 위치에서 시작하는 편집 가능한 문자 범위를 지정된 문자열로 바꾼 다음 제거 위치 및 설명 정보를 출력합니다. |
| Replace(String, Int32) |
지정된 위치에서 시작하여 편집 가능한 문자 범위를 지정된 문자열로 바꿉니다. |
| Set(String, Int32, MaskedTextResultHint) |
서식이 지정된 문자열을 지정된 입력 문자열로 설정한 다음 제거 위치 및 설명 정보를 출력합니다. |
| Set(String) |
서식이 지정된 문자열을 지정된 입력 문자열로 설정합니다. |
| ToDisplayString() |
서식이 지정된 문자열을 표시 가능한 형식으로 반환합니다. |
| ToString() |
할당된 모든 문자 값을 포함하는 서식이 지정된 문자열을 반환합니다. |
| ToString(Boolean, Boolean, Boolean, Int32, Int32) |
필요에 따라 프롬프트, 리터럴 및 암호 문자를 포함하여 서식이 지정된 문자열의 부분 문자열을 반환합니다. |
| ToString(Boolean, Boolean, Int32, Int32) |
필요에 따라 프롬프트 및 리터럴 문자를 포함하여 서식이 지정된 문자열의 부분 문자열을 반환합니다. |
| ToString(Boolean, Boolean) |
필요에 따라 프롬프트 및 리터럴 문자를 포함하여 서식이 지정된 문자열을 반환합니다. |
| ToString(Boolean, Int32, Int32) |
선택적으로 암호 문자를 포함하여 서식이 지정된 문자열의 부분 문자열을 반환합니다. |
| ToString(Boolean) |
필요에 따라 암호 문자를 포함하여 서식이 지정된 문자열을 반환합니다. |
| ToString(Int32, Int32) |
서식이 지정된 문자열의 부분 문자열을 반환합니다. |
| VerifyChar(Char, Int32, MaskedTextResultHint) |
지정된 문자가 지정된 위치에서 성공적으로 설정될 수 있는지 여부를 테스트합니다. |
| VerifyEscapeChar(Char, Int32) |
지정된 문자가 지정된 위치에서 이스케이프되는지 여부를 테스트합니다. |
| VerifyString(String, Int32, MaskedTextResultHint) |
지정된 문자열을 성공적으로 설정할 수 있는지 테스트한 다음 위치 및 설명 정보를 출력합니다. |
| VerifyString(String) |
지정된 문자열을 성공적으로 설정할 수 있는지 여부를 테스트합니다. |
적용 대상
추가 정보
.NET