MaskedTextProvider.InsertAt 메서드

정의

서식이 지정된 문자열의 특정한 위치에 문자나 문자열을 삽입합니다.Inserts a character or string at a specific position within the formatted string.

오버로드

InsertAt(Char, Int32)

서식이 지정된 문자열의 지정된 위치에 지정한 문자를 삽입합니다.Inserts the specified character at the specified position within the formatted string.

InsertAt(String, Int32)

서식이 지정된 문자열의 지정된 위치에 지정한 문자열을 삽입합니다.Inserts the specified string at a specified position within the formatted string.

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

서식이 지정된 문자열의 지정된 위치에 지정한 문자를 삽입하고 마지막 삽입 위치와 작업의 상태를 반환합니다.Inserts the specified character at the specified position within the formatted string, returning the last insertion position and the status of the operation.

InsertAt(String, Int32, Int32, MaskedTextResultHint)

서식이 지정된 문자열의 지정된 위치에 지정한 문자열을 삽입하고 마지막 삽입 위치와 작업의 상태를 반환합니다.Inserts the specified string at a specified position within the formatted string, returning the last insertion position and the status of the operation.

InsertAt(Char, Int32)

서식이 지정된 문자열의 지정된 위치에 지정한 문자를 삽입합니다.Inserts the specified character at the specified position within the formatted string.

public:
 bool InsertAt(char input, int position);
public bool InsertAt (char input, int position);
member this.InsertAt : char * int -> bool
Public Function InsertAt (input As Char, position As Integer) As Boolean

매개 변수

input
Char

삽입할 Char입니다.The Char to be inserted.

position
Int32

문자를 삽입할 서식이 지정된 문자열의 위치(0부터 시작)입니다.The zero-based position in the formatted string to insert the character.

반환

성공적으로 삽입되었으면 true이고, 그렇지 않으면 false입니다.true if the insertion was successful; otherwise, false.

설명

InsertAt 메서드는 문자를 pos 매개 변수로 지정 된 또는 그 뒤의 첫 번째 편집 위치에 삽입 합니다.The InsertAt method inserts a character into the first edit position at or beyond that specified by the pos parameter. 이 메서드는 삽입 지점 뒤의 모든 기존 문자를 한 위치 만큼 이동 하 여 삽입 된 input 문자를 위한 공간을 만듭니다.This method will shift all existing characters after the insertion point over by one position to make room for the inserted input character. 다음 오류 중 하나가 발생 하는 경우 삽입이 수행 되지 않고 메서드에서 false을 반환 합니다.If one of the following errors occurs, the insertion is not performed, and the method returns false.

  • pos 매개 변수가 0 보다 작거나 형식이 지정 된 문자열의 Length 보다 큰 경우The pos parameter is less than zero or greater than the Length of the formatted string.

  • 서식이 지정 된 문자열에서 지정 된 위치 (pos)를 벗어난 편집 가능한 문자를 찾을 수 없습니다.An editable character was not found in the formatted string at or beyond the specified position, pos.

  • 삽입 문자 input은 인쇄할 수 없거나 해당 하는 마스크 요소와 일치 하지 않기 때문에 유효한 입력 문자가 아닙니다.The insertion character, input, is not a valid input character because it is not printable or does not match its corresponding mask element.

  • 기존 문자를 이동할 수 없습니다 있도록 삽입 지점의 오른쪽에 사용할 수 없는 위치가 있습니다.There are no available positions to the right of the insertion point, so that existing characters cannot be shifted.

  • 기존 문자를 이동 하면 마스크의 위반이 발생 합니다.Shifting the existing characters would produce a violation of the mask.

input 문자열은 형식이 지정 된 문자열을 변경 하지 않지만 true를 반환 합니다.An empty input string will cause no change in the formatted string, but will return true.

추가 정보

InsertAt(String, Int32)

서식이 지정된 문자열의 지정된 위치에 지정한 문자열을 삽입합니다.Inserts the specified string at a specified position within the formatted string.

public:
 bool InsertAt(System::String ^ input, int position);
public bool InsertAt (string input, int position);
member this.InsertAt : string * int -> bool
Public Function InsertAt (input As String, position As Integer) As Boolean

매개 변수

input
String

삽입할 String입니다.The String to be inserted.

position
Int32

입력 문자열을 삽입할 서식이 지정된 문자열의 위치(0부터 시작)입니다.The zero-based position in the formatted string to insert the input string.

반환

성공적으로 삽입되었으면 true이고, 그렇지 않으면 false입니다.true if the insertion was successful; otherwise, false.

예외

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

설명

InsertAt 메서드는 input 문자열의 각 문자를 pos 위치에 있는 편집 위치에 삽입 합니다.The InsertAt method inserts each character from the input string into the edit positions located at position pos and beyond. 이 메서드는 각각에 대 한 위치를 하나씩 삽입 지점을 문자를 삽입 한 후 모든 기존 문자를 이동 합니다.This method will shift all existing characters after the insertion point over by one position for each inserted character. 다음 오류 중 하나가 발생 하는 경우 삽입이 수행 되지 않고 메서드에서 false을 반환 합니다.If one of the following errors occurs, no insertion is performed, and the method returns false.

  • pos 매개 변수가 0 보다 작거나 형식이 지정 된 문자열의 Length 보다 큰 경우The pos parameter is less than zero or greater than the Length of the formatted string.

  • input 문자열의 모든 문자를 삽입 하기 위해 지정 된 위치 또는 그 뒤의 서식이 지정 된 문자열에 있는 편집 가능한 문자가 충분 하지 않습니다. pos.Not enough editable characters exist in the formatted string at or beyond the specified position, pos, to insert all of the characters from the input string.

  • 하나 이상의 문자를 삽입 되지 유효한 입력된 문자는 인쇄 되지 않음 있거나 해당 마스크 요소를 일치 하지 않습니다.One or more of the insertion characters are not a valid input character because they are not printable or do not match their corresponding mask element.

  • 않습니다 삽입 지점의 오른쪽에 충분히 사용할 수 있는 위치를 기존 문자를 이동할 수 없습니다.There are not enough available positions to the right of the insertion point, so that existing characters cannot be shifted.

  • 기존 문자를 이동 하면 마스크의 위반이 발생 합니다.Shifting the existing characters would produce a violation of the mask. 이 전환의 각 개별 문자 삽입 하는 동안 발생 합니다. 참고 합니다.Note that this shifting occurs during the insertion of each individual character.

input 문자열은 형식이 지정 된 문자열을 변경 하지 않지만 true를 반환 합니다.An empty input string will cause no change in the formatted string, but will return true.

추가 정보

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

서식이 지정된 문자열의 지정된 위치에 지정한 문자를 삽입하고 마지막 삽입 위치와 작업의 상태를 반환합니다.Inserts the specified character at the specified position within the formatted string, returning the last insertion position and the status of the operation.

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

매개 변수

input
Char

삽입할 Char입니다.The Char to be inserted.

position
Int32

문자를 삽입할 서식이 지정된 문자열의 위치(0부터 시작)입니다.The zero-based position in the formatted string to insert the character.

testPosition
Int32

메서드가 성공적으로 수행되면 문자가 삽입된 마지막 위치이고, 그렇지 않으면 삽입에 실패한 첫 번째 위치입니다.If the method is successful, the last position where a character was inserted; otherwise, the first position where the insertion failed. 출력 매개 변수입니다.An output parameter.

resultHint
MaskedTextResultHint

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

반환

성공적으로 삽입되었으면 true이고, 그렇지 않으면 false입니다.true if the insertion was successful; otherwise, false.

설명

InsertAt 메서드는 문자를 pos 매개 변수로 지정 된 또는 그 뒤의 첫 번째 편집 위치에 삽입 합니다.The InsertAt method inserts a character into the first edit position at or beyond that specified by the pos parameter. 이 메서드는 삽입 지점 뒤의 모든 기존 문자를 한 위치 만큼 이동 하 여 삽입 된 input 문자를 위한 공간을 만듭니다.This method will shift all existing characters after the insertion point over by one position to make room for the inserted input character. 다음 오류 중 하나가 발생 하는 경우 삽입이 수행 되지 않고 메서드에서 false을 반환 합니다.If one of the following errors occurs, the insertion is not performed, and the method returns false.

  • pos 매개 변수가 0 보다 작거나 형식이 지정 된 문자열의 Length 보다 큰 경우The pos parameter is less than zero or greater than the Length of the formatted string.

  • 서식이 지정 된 문자열에서 지정 된 위치 (pos)를 벗어난 편집 가능한 문자를 찾을 수 없습니다.An editable character was not found in the formatted string at or beyond the specified position, pos.

  • 삽입 문자 input은 인쇄할 수 없거나 해당 하는 마스크 요소와 일치 하지 않기 때문에 유효한 입력 문자가 아닙니다.The insertion character, input, is not a valid input character because it is not printable or does not match its corresponding mask element.

  • 기존 문자를 이동할 수 없습니다 있도록 삽입 지점의 오른쪽에 사용할 수 없는 위치가 있습니다.There are no available positions to the right of the insertion point, so that existing characters cannot be shifted.

  • 기존 문자를 이동 하면 마스크의 위반이 발생 합니다.Shifting the existing characters would produce a violation of the mask.

input 문자열은 형식이 지정 된 문자열을 변경 하지 않지만 true를 반환 합니다.An empty input string will cause no change in the formatted string, but will return true.

추가 정보

InsertAt(String, Int32, Int32, MaskedTextResultHint)

서식이 지정된 문자열의 지정된 위치에 지정한 문자열을 삽입하고 마지막 삽입 위치와 작업의 상태를 반환합니다.Inserts the specified string at a specified position within the formatted string, returning the last insertion position and the status of the operation.

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

매개 변수

input
String

삽입할 String입니다.The String to be inserted.

position
Int32

입력 문자열을 삽입할 서식이 지정된 문자열의 위치(0부터 시작)입니다.The zero-based position in the formatted string to insert the input string.

testPosition
Int32

메서드가 성공적으로 수행되면 문자가 삽입된 마지막 위치이고, 그렇지 않으면 삽입에 실패한 첫 번째 위치입니다.If the method is successful, the last position where a character was inserted; otherwise, the first position where the insertion failed. 출력 매개 변수입니다.An output parameter.

resultHint
MaskedTextResultHint

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

반환

성공적으로 삽입되었으면 true이고, 그렇지 않으면 false입니다.true if the insertion was successful; otherwise, false.

예외

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

설명

InsertAt 메서드는 input 문자열의 각 문자를 pos 위치에 있는 편집 위치에 삽입 합니다.The InsertAt method inserts each character from the input string into the edit positions located at position pos and beyond. 이 메서드는 각각에 대 한 위치를 하나씩 삽입 지점을 문자를 삽입 한 후 모든 기존 문자를 이동 합니다.This method will shift all existing characters after the insertion point over by one position for each inserted character. 다음 오류 중 하나가 발생 하는 경우 삽입이 수행 되지 않고 메서드에서 false을 반환 합니다.If one of the following errors occurs, no insertion is performed, and the method returns false.

  • pos 매개 변수가 0 보다 작거나 형식이 지정 된 문자열의 Length 보다 큰 경우The pos parameter is less than zero or greater than the Length of the formatted string.

  • input 문자열의 모든 문자를 삽입 하기 위해 지정 된 위치 또는 그 뒤의 서식이 지정 된 문자열에 있는 편집 가능한 문자가 충분 하지 않습니다. pos.Not enough editable characters exist in the formatted string at or beyond the specified position, pos, to insert all of the characters from the input string.

  • 하나 이상의 문자를 삽입 되지 유효한 입력된 문자는 인쇄 되지 않음 있거나 해당 마스크 요소를 일치 하지 않습니다.One or more of the insertion characters are not a valid input character because they are not printable or do not match their corresponding mask element.

  • 않습니다 삽입 지점의 오른쪽에 충분히 사용할 수 있는 위치를 기존 문자를 이동할 수 없습니다.There are not enough available positions to the right of the insertion point, so that existing characters cannot be shifted.

  • 기존 문자를 이동 하면 마스크의 위반이 발생 합니다.Shifting the existing characters would produce a violation of the mask. 이 전환의 각 개별 문자 삽입 하는 동안 발생 합니다. 참고 합니다.Note that this shifting occurs during the insertion of each individual character.

input 문자열은 형식이 지정 된 문자열을 변경 하지 않지만 true를 반환 합니다.An empty input string will cause no change in the formatted string, but will return true.

추가 정보

적용 대상