共用方式為


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*

將簡體中文字元轉換為繁體中文。

*:適用於亞洲地區設定 (Locale)。

**:僅適用於日本。

注意事項:

這些常數是在 .NET Framework Common Language Runtime 中指定。因此,程式碼中的任何位置都可使用這些常數來取代實際值。大部分的這些常數都可以結合起來 (例如 VbStrConv.Wide + VbStrConv.Narrow),但是在彼此互斥時除外 (例如,UpperCase + Wide)。

下列是適當大小寫的有效文字分隔符號:Null (Chr$(0))、水平索引標籤 (Chr$(9))、換行 (Chr$(10))、垂直索引標籤 (Chr$(11))、換頁 (Chr$(12))、歸位 (Chr$(13))、空格 (單一位元組字元集 (Single-Byte Character Set)) (Chr$(32))。空格的實際值 (可以是全形或半形),會因東亞文化特性的所在國家或地區而異。

例外狀況

例外狀況類型

錯誤代碼

條件

ArgumentException

5

不支援的 LocaleID、Conversion < 0 或 > 2048,或是指定地區設定不支援的轉換。

如果將使用非結構化錯誤處理的 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 引數的 OrdinalOrdinalIgnoreCase。如需詳細資訊,請參閱在 Visual Basic 中文化特性如何影響字串

範例

本範例將文字轉換為小寫字母。

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

智慧型裝置開發人員注意事項

不支援這個函式。

需求

命名空間Microsoft.VisualBasic

模組:Strings

組件:Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)

請參閱

參考

字串操作摘要

Chr、ChrW 函式

String 資料型別 (Visual Basic)

型別轉換函式

ArgumentException