StrConv 함수

업데이트: 2007년 11월

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

Public Shared Function StrConv( _
   ByVal str As String, _
   ByVal Conversion As Microsoft.VisualBasic.VbStrConv, _
   Optional ByVal LocaleID As Integer, 
) As String

매개 변수

  • str
    필수 요소. 변환될 String 식입니다.

  • Conversion
    필수 요소. VbStrConv 열거형 멤버입니다. 수행할 변환 형식을 지정하는 열거형 값입니다.

  • LocaleID
    선택적 요소. LocaleID 값(응용 프로그램의 현재 문화권 값과 다른 경우)입니다. 로캘 ID 및 문화권 정보에 대한 자세한 내용은 CultureInfo를 참조하십시오. 기본값은 응용 프로그램의 현재 문화권 값입니다.

설정

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

열거형 멤버

설명

VbStrConv.None

변환을 수행하지 않습니다.

VbStrConv.LinguisticCasing

파일 시스템(기본값)이 아닌 대/소문자에 대한 언어 규칙을 사용합니다. VbStrConv.UpperCase 및 VbStrConv.LowerCase에만 유효합니다.

VbStrConv.UpperCase

문자열을 대문자로 변환합니다.

VbStrConv.LowerCase

문자열을 소문자로 변환합니다.

VbStrConv.ProperCase

문자열에서 모든 단어의 첫 글자를 대문자로 변환합니다.

VbStrConv.Wide*

문자열에서 좁은 문자(반자)를 넓은 문자(전자)로 변환합니다.

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)) 등입니다. 전자 또는 반자가 될 수 있는 공백의 실제 값은 동아시아 문화권의 국가/지역마다 다릅니다.

예외

예외 형식

오류 번호

조건

ArgumentException

5

지원되지 않는 LocaleID이거나, 0보다 작거나 2048보다 큰 Conversion이거나, 지정한 로캘에서 지원되지 않는 변환입니다.

비구조적 오류 처리를 사용하는 Visual Basic 6.0 응용 프로그램을 업그레이드하는 경우에는 "오류 번호" 열을 참조하십시오. 오류 번호를 Number 속성(Err 개체)과 비교할 수 있습니다. 그러나 가능하면 이러한 오류 제어 방법을 Visual Basic의 구조적 예외 처리 개요에 설명된 방식으로 바꾸는 것이 좋습니다.

설명

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에서 문화권이 문자열에 영향을 주는 방식을 참조하십시오.

예제

다음 예제에서는 텍스트를 모두 소문자로 변환합니다.

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

스마트 장치 개발자 참고 사항

이 함수는 지원되지 않습니다.

요구 사항

네임스페이스:Microsoft.VisualBasic

**모듈:**Strings

**어셈블리:**Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)

참고 항목

참조

문자열 조작 요약

Chr, ChrW 함수

String 데이터 형식(Visual Basic)

형식 변환 함수

ArgumentException