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