MaskedTextProvider.Set 메서드

정의

서식이 지정된 문자열을 지정된 입력 문자열로 설정합니다.Sets the formatted string to the specified input string.

오버로드

Set(String)

서식이 지정된 문자열을 지정된 입력 문자열로 설정합니다.Sets the formatted string to the specified input string.

Set(String, Int32, MaskedTextResultHint)

서식이 지정된 문자열을 지정된 입력 문자열로 설정한 다음 제거 위치와 설명 정보를 출력합니다.Sets the formatted string to the specified input string, and then outputs the removal position and descriptive information.

Set(String)

서식이 지정된 문자열을 지정된 입력 문자열로 설정합니다.Sets the formatted string to the specified input string.

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

매개 변수

input
String

서식이 지정된 문자열을 설정하는 데 사용되는 String 값입니다.The String value used to set the formatted string.

반환

모든 문자가 성공적으로 설정되었으면 true이고, 그렇지 않으면 false입니다.true if all the characters were successfully set; otherwise, false.

예외

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

설명

Set 메서드는 서식이 지정 된 문자열의 기존 내용을 지운 다음 input 문자열에 마스크를 적용 하 여 서식이 지정 된 문자열의 내용을 업데이트 합니다.The Set method clears the existing contents of the formatted string and then applies the mask against the input string to update the contents of the formatted string.

다음 조건에는 오류로 간주 됩니다.The following conditions are considered errors. 오류가 발생 하면 서식이 지정 된 문자열은 변경 되지 않은 상태로 유지 되 고 Set false반환 됩니다.When an error occurs, the formatted string remains unaltered and Set returns false.

  • 대체 문자열의 내용을 포함할 수 서식이 지정 된 문자열의 편집 가능한 위치 충분 하지 않습니다.There are not enough editable positions in the formatted string to hold the contents of the replacement string.

  • 대체 문자 값 중 하나가 아니므로 유효한 인쇄 가능 하지 않거나 해당 마스크 요소를 맞지 않습니다.One of the replacement character values is not valid because it is not printable or does not match its corresponding mask element.

추가 정보

Set(String, Int32, MaskedTextResultHint)

서식이 지정된 문자열을 지정된 입력 문자열로 설정한 다음 제거 위치와 설명 정보를 출력합니다.Sets the formatted string to the specified input string, and then outputs the removal position and descriptive information.

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

매개 변수

input
String

서식이 지정된 문자열을 설정하는 데 사용되는 String 값입니다.The String value used to set the formatted string.

testPosition
Int32

성공하면 서식이 지정된 문자열에서 마지막 문자가 실제로 설정된 위치(0부터 시작)이고, 그렇지 않으면 작업에 실패한 첫 번째 위치입니다.If successful, the zero-based position in the formatted string where the last character was actually set; otherwise, the first position where the operation failed. 출력 매개 변수입니다.An output parameter.

resultHint
MaskedTextResultHint

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

반환

모든 문자가 성공적으로 설정되었으면 true이고, 그렇지 않으면 false입니다.true if all the characters were successfully set; otherwise, false.

예외

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

설명

Set 메서드는 서식이 지정 된 문자열의 기존 내용을 지운 다음 input 문자열에 마스크를 적용 하 여 서식이 지정 된 문자열의 내용을 업데이트 합니다.The Set method clears the existing contents of the formatted string and then applies the mask against the input string to update the contents of the formatted string.

다음 조건에는 오류로 간주 됩니다.The following conditions are considered errors. 오류가 발생 하면 서식이 지정 된 문자열은 변경 되지 않은 상태로 유지 되 고 Set false반환 됩니다.When an error occurs, the formatted string remains unaltered and Set returns false.

  • 대체 문자열의 내용을 포함할 수 서식이 지정 된 문자열의 편집 가능한 위치 충분 하지 않습니다.There are not enough editable positions in the formatted string to hold the contents of the replacement string.

  • 대체 문자 값 중 하나가 아니므로 유효한 인쇄 가능 하지 않거나 해당 마스크 요소를 맞지 않습니다.One of the replacement character values is not valid because it is not printable or does not match its corresponding mask element.

이 버전의 Set는 메서드 작업에 대 한 추가 정보를 전달 하기 위해 두 개의 추가 출력 매개 변수를 제공 합니다.This version of Set provides two additional output parameters to convey more information about the operation of the method.

추가 정보

적용 대상