다음을 통해 공유

Strings.StrConv(String, VbStrConv, Int32) 메서드

  • 참조

정의

네임스페이스:
Microsoft.VisualBasic
어셈블리:
Microsoft.VisualBasic.Core.dll
어셈블리:
Microsoft.VisualBasic.dll
Source:
Strings.vb
Source:
Strings.vb
Source:
Strings.vb

지정된 대로 변환된 문자열을 반환합니다.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string? StrConv (string? str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);
public static string StrConv (string str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> string
static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> string
Public Function StrConv (str As String, Conversion As VbStrConv, Optional LocaleID As Integer = 0) As String

매개 변수

str
String

필수. 변환할 String 식입니다.

Conversion
VbStrConv

필수. VbStrConv 멤버입니다. 수행할 변환 유형을 지정하는 열거형 값입니다.

LocaleID
Int32

선택적. 시스템 LocaleID 값과 다른 경우 LocaleID 값입니다. (시스템 LocaleID 값이 기본값입니다.)

반환

String

지정된 대로 변환된 문자열입니다.

특성
SupportedOSPlatformAttribute

예외

ArgumentException

지원되지 않는 LocaleID, Conversion< 0 또는 > 2048 또는 지정된 로캘에 대해 지원되지 않는 변환입니다.

예제

다음은 텍스트를 모두 소문자로 변환하는 예제입니다.

Dim sText As String = "Hello World"
' Returns "hello world".
Dim sNewText As String = StrConv(sText, VbStrConv.LowerCase)

설명

상수 VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakana및 VbStrConv.Hiragana 적용되지 않지만 항상 적용되지 않는 로캘에서 사용할 때 런타임 오류가 발생할 수 있습니다. VbStrConv.Katakana 및 VbStrConv.Hiragana 일본어 언어 팩이 설치된 일본어 이외의 시스템에서 사용할 수 있습니다. 또한 상수 VbStrConv.Wide 및 VbStrConv.Narrow 사용은 동아시아 언어가 설치된 모든 시스템에서 지원됩니다.

이 함수는 문자열을 조작할 때 애플리케이션의 문화권 정보를 사용하므로 애플리케이션이 사용되는 로캘에 대/소문자 변경 내용이 적합합니다.

중요하다

애플리케이션이 비교 또는 대/소문자 변경 작업의 결과에 따라 보안 결정을 내리는 경우 작업은 String.Compare 메서드를 사용하고 comparisonType 인수에 대한 Ordinal 또는 OrdinalIgnoreCase 전달해야 합니다. 자세한 내용은 Visual Basic문화권이 문자열에 미치는 영향 참조하세요.

Conversion 인수 설정은 다음과 같습니다.

열거형 멤버 묘사
VbStrConv.None 변환을 수행하지 않습니다.
VbStrConv.LinguisticCasing 파일 시스템(기본값)이 아닌 대/소문자 구분에 언어 규칙을 사용합니다. VbStrConv.UpperCase 및 VbStrConv.LowerCase 경우에만 유효합니다.
VbStrConv.UpperCase 문자열을 대문자로 변환합니다.
VbStrConv.LowerCase 문자열을 소문자로 변환합니다.
VbStrConv.ProperCase 문자열에 있는 모든 단어의 첫 글자를 대문자로 변환합니다.
VbStrConv.Wide * 문자열의 좁은(반자) 문자를 와이드(전체 너비) 문자로 변환합니다. 입력 문자가 이미 전체 너비인 경우에도 변환에서 정규화 양식 C를 사용할 수 있습니다. 예를 들어 문자열 "は 1"(이미 전체 너비임)은 "こ"로 정규화됩니다. 유니코드 정규화 양식참조하세요.
VbStrConv.Narrow * 문자열의 와이드(전체 너비) 문자를 좁은(반자) 문자로 변환합니다.
VbStrConv.Katakana ** 문자열의 히라가나 문자를 가타카나 문자로 변환합니다.
VbStrConv.Hiragana ** 문자열의 가타카나 문자를 히라가나 문자로 변환합니다.
VbStrConv.SimplifiedChinese * 중국어 번체 문자를 중국어 간체로 변환합니다.
VbStrConv.TraditionalChinese * 중국어 간체 문자를 중국어 번체로 변환합니다.

* 아시아 로캘에 적용됩니다.

** 일본에만 적용됩니다.

메모

이러한 상수는 .NET Framework 공용 언어 런타임에 지정됩니다. 따라서 실제 값 대신 코드의 어디에서나 사용할 수 있습니다. 상호 배타적(예: VbStrConv.Wide + VbStrConv.Narrow)인 경우를 제외하고 대부분(예: UpperCase + Wide)을 결합할 수 있습니다.

적절한 대/소문자 구분 기호는 Null(Chr$(0)), 가로 탭(Chr$(9)), 줄 바꿈(Chr$(10)), 세로 탭(Chr$(11)), 폼 피드(Chr$(12)), 캐리지 리턴(Chr$(13)), 공백(싱글바이트 문자 집합)(Chr$(32))입니다. 전체 또는 반 너비일 수 있는 공간의 실제 값은 동아시아 문화권의 국가/지역에 따라 다릅니다.

적용 대상

추가 정보