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 引數的 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 Runtime Library (在 Microsoft.VisualBasic.dll 中)

請參閱

參考

字串操作摘要

Chr、ChrW 函式

String 資料型別 (Visual Basic)

型別轉換函式

ArgumentException