MaskedTextProvider 클래스

정의

MaskedTextBox 컨트롤과 같이 마스킹을 지원하는 컨트롤에서 사용할 수 있는 마스크 구문 분석 서비스를 나타냅니다.

public ref class MaskedTextProvider : ICloneable
public class MaskedTextProvider : ICloneable
type MaskedTextProvider = class
    interface ICloneable
Public 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
입력 문자 또는 문자열 마스크가 적용되는 입력으로 사용되는 문자를 나타냅니다. 실제로 입력 문자열은 , , ReplaceInsertAtRemove를 비롯한 Add여러 입력 작업으로 구성될 수 있습니다. 따라서 입력 문자열에 직접 액세스할 수 없습니다. 그러나 입력 문자열 처리의 측면은 및 AsciiOnly, ResetOnPromptResetOnSpace 속성을 통해 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)

지정된 문자열이 성공적으로 설정될 수 있는지 여부를 테스트한 다음 위치와 설명 정보를 출력합니다.

적용 대상

추가 정보