MaskedTextProvider.Add 메서드

정의

서식이 지정된 문자열에 입력 문자나 입력 문자열을 추가합니다.Adds an input character or input string to the formatted string.

오버로드

Add(String, Int32, MaskedTextResultHint)

서식이 지정된 문자열의 끝에 지정된 입력 문자열의 문자를 추가한 다음 위치와 설명 정보를 출력합니다.Adds the characters in the specified input string to the end of the formatted string, and then outputs position and descriptive information.

Add(Char, Int32, MaskedTextResultHint)

서식이 지정된 문자열의 끝에 지정된 입력 문자를 추가한 다음 위치와 설명 정보를 출력합니다.Adds the specified input character to the end of the formatted string, and then outputs position and descriptive information.

Add(Char)

서식이 지정된 문자열의 끝에 지정된 입력 문자를 추가합니다.Adds the specified input character to the end of the formatted string.

Add(String)

서식이 지정된 문자열의 끝에 지정된 입력 문자열의 문자를 추가합니다.Adds the characters in the specified input string to the end of the formatted string.

Add(String, Int32, MaskedTextResultHint)

서식이 지정된 문자열의 끝에 지정된 입력 문자열의 문자를 추가한 다음 위치와 설명 정보를 출력합니다.Adds the characters in the specified input string to the end of the formatted string, and then outputs position and descriptive information.

public:
 bool Add(System::String ^ input, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Add (string input, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Add : string * int * MaskedTextResultHint -> bool
Public Function Add (input As String, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

매개 변수

input
String

서식이 지정된 문자열에 추가할 문자 값을 포함하는 String입니다.A String containing character values to be appended to the formatted string.

testPosition
Int32

문자를 추가하려고 한 서식이 지정된 문자열의 위치(0부터 시작)입니다.The zero-based position in the formatted string where the attempt was made to add the character. 출력 매개 변수입니다.An output parameter.

resultHint
MaskedTextResultHint

작업의 결과를 간략하게 설명하는 MaskedTextResultHint입니다.A MaskedTextResultHint that succinctly describes the result of the operation. 출력 매개 변수입니다.An output parameter.

반환

입력 문자열의 모든 문자가 성공적으로 추가되었으면 true이고, 추가된 문자가 없음을 나타내면 false입니다.true if all the characters from the input string were added successfully; otherwise false to indicate that no characters were added.

설명

Add(String, Int32, MaskedTextResultHint) 메서드는 input 문자열의 문자를 형식이 지정 된 문자열에 추가 합니다. LastAssignedPosition후에 사용 가능한 첫 번째 위치부터 시작 합니다.The Add(String, Int32, MaskedTextResultHint) method adds the characters from the input string to the formatted string, starting with the first available position after LastAssignedPosition. 이 메서드는 다음과 같은 이유로 인해 실패 합니다.This method will fail for any of the following reasons:

  • 입력 값 input에 있는 모든 문자를 인쇄할 수 없거나 입력 값이 해당 mask 요소와 일치 하지 않습니다.Any of the characters in the input value, input, are not printable, or the input value does not match its corresponding mask element.

  • 않습니다 서식이 지정 된 문자열에서 사용할 수 있는 편집 위치가 충분 한 후 마지막 할당 된 위치.There are not enough available edit positions in the formatted string after the last assigned position.

이 메서드가 실패 하면 추가 작업이 수행 되지 않고 메서드에서 false을 반환 합니다.If this method fails, no additions are made and the method returns false.

이 메서드는 추가 정보를 출력 한다는 점을 제외 하 고 Add(String)단일 String 매개 변수를 가져오는 재정의 된 버전과 동일 하 게 작동 합니다.This method functions the same as the overridden version taking a single String parameter, Add(String), except that it outputs additional information.

추가 정보

Add(Char, Int32, MaskedTextResultHint)

서식이 지정된 문자열의 끝에 지정된 입력 문자를 추가한 다음 위치와 설명 정보를 출력합니다.Adds the specified input character to the end of the formatted string, and then outputs position and descriptive information.

public:
 bool Add(char input, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Add (char input, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Add : char * int * MaskedTextResultHint -> bool
Public Function Add (input As Char, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

매개 변수

input
Char

서식이 지정된 문자열에 추가할 Char 값입니다.A Char value to be appended to the formatted string.

testPosition
Int32

문자를 추가하려고 한 서식이 지정된 문자열의 위치(0부터 시작)입니다.The zero-based position in the formatted string where the attempt was made to add the character. 출력 매개 변수입니다.An output parameter.

resultHint
MaskedTextResultHint

작업의 결과를 간략하게 설명하는 MaskedTextResultHint입니다.A MaskedTextResultHint that succinctly describes the result of the operation. 출력 매개 변수입니다.An output parameter.

반환

입력 문자가 성공적으로 추가되었으면 true이고, 그렇지 않으면 false입니다.true if the input character was added successfully; otherwise false.

설명

Add(Char, Int32, MaskedTextResultHint) 메서드는 LastAssignedPosition 속성이 나타내는 마지막으로 할당 된 위치 뒤의 서식이 지정 된 문자열에서 사용 가능한 첫 번째 위치에 input 문자 값을 추가 하려고 합니다.The Add(Char, Int32, MaskedTextResultHint) method attempts to add the input character value to the first available position in the formatted string after the position that was last assigned, which is represented by the LastAssignedPosition property. 이 메서드는 마지막 할당 된 위치 앞에 사용 가능한 모든 위치가 경우 실패 합니다.This method will fail if all available positions are before the last assigned position. 이 메서드는 다음과 같은 이유로 인해 실패 합니다.This method will fail for any of the following reasons:

  • 입력 값 input는 인쇄할 수 없거나 해당 mask 요소와 일치 하지 않습니다.The input value, input, is not printable, or it does not match its corresponding mask element.

  • 서식이 지정 된 문자열에서 사용할 수 있는 편집 위치가 0 개 또는 가지 다음 마지막 할당 된 후 사용할 수 있는 편집 위치가 없습니다.There are zero available edit positions in the formatted string, or there are no available edit positions after the last assigned position.

이 메서드는 추가 정보를 출력 한다는 점을 제외 하 고 Add(Char)단일 Char 매개 변수를 가져오는 재정의 된 버전과 동일 하 게 작동 합니다.This method functions the same as the overridden version taking a single Char parameter, Add(Char), except that it outputs additional information.

추가 정보

Add(Char)

서식이 지정된 문자열의 끝에 지정된 입력 문자를 추가합니다.Adds the specified input character to the end of the formatted string.

public:
 bool Add(char input);
public bool Add (char input);
member this.Add : char -> bool
Public Function Add (input As Char) As Boolean

매개 변수

input
Char

서식이 지정된 문자열에 추가할 Char 값입니다.A Char value to be appended to the formatted string.

반환

입력 문자가 성공적으로 추가되었으면 true이고, 그렇지 않으면 false입니다.true if the input character was added successfully; otherwise false.

설명

Add(Char) 메서드는 LastAssignedPosition 속성으로 표시 되는 마지막으로 할당 된 위치 뒤에 서식이 지정 된 문자열의 첫 번째 사용 가능한 위치에 input 문자 값을 추가 합니다.The Add(Char) method adds the input character value to the first available position in the formatted string after the position that was last assigned, which is represented by the LastAssignedPosition property. 이 메서드는 다음과 같은 이유로 인해 실패 합니다.This method will fail for any of the following reasons:

  • 입력 값 input는 인쇄할 수 없거나 해당 mask 요소와 일치 하지 않습니다.The input value, input, is not printable, or it does not match its corresponding mask element.

  • 서식이 지정 된 문자열에서 사용할 수 있는 편집 위치가 0 개 또는 가지 다음 마지막 할당 된 후 사용할 수 있는 편집 위치가 없습니다.There are zero available edit positions in the formatted string, or there are no available edit positions after the last assigned position.

추가 정보

Add(String)

서식이 지정된 문자열의 끝에 지정된 입력 문자열의 문자를 추가합니다.Adds the characters in the specified input string to the end of the formatted string.

public:
 bool Add(System::String ^ input);
public bool Add (string input);
member this.Add : string -> bool
Public Function Add (input As String) As Boolean

매개 변수

input
String

서식이 지정된 문자열에 추가할 문자 값을 포함하는 String입니다.A String containing character values to be appended to the formatted string.

반환

입력 문자열의 모든 문자가 성공적으로 추가되었으면 true이고, 추가된 문자가 없음을 나타내면 false입니다.true if all the characters from the input string were added successfully; otherwise false to indicate that no characters were added.

예외

input 매개 변수가 null인 경우The input parameter is null.

설명

Add(String) 메서드는 input 문자열의 문자를 형식이 지정 된 문자열에 추가 합니다. LastAssignedPosition후에 사용 가능한 첫 번째 위치부터 시작 합니다.The Add(String) method adds the characters from the input string to the formatted string, starting with the first available position after LastAssignedPosition. 이 메서드는 다음과 같은 이유로 인해 실패 합니다.This method will fail for any of the following reasons:

  • 입력 값 input에 있는 모든 문자를 인쇄할 수 없거나 입력 값이 해당 mask 요소와 일치 하지 않습니다.Any of the characters in the input value, input, are not printable, or the input value does not match its corresponding mask element.

  • 않습니다 서식이 지정 된 문자열에서 사용할 수 있는 편집 위치가 충분 한 후 마지막 할당 된 위치.There are not enough available edit positions in the formatted string after the last assigned position.

이 메서드가 실패 하면 추가 작업이 수행 되지 않고 메서드에서 false을 반환 합니다.If this method fails, no additions are made and the method returns false.

추가 정보

적용 대상