Strings.StrConv(String, VbStrConv, Int32) 方法

定義

命名空間:
Microsoft.VisualBasic
組件:
Microsoft.VisualBasic.dll

回傳一個依規定轉換的字串。

public static string StrConv(string str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);
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

Optional. LocaleID如果該值與系統LocaleID值不同。 （系統 LocaleID 值為預設值。）

傳回

String

一串依規定轉換的字串。

例外狀況

ArgumentException

不支援 LocaleID、 Conversion< 0 或 > 2048，或指定區域的不支援轉換。

範例

此範例將文字轉換為所有小寫字母。

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

備註

常數 、 、 VbStrConv.TraditionalChinese、 、 在VbStrConv.Hiragana不適用的地區使用時可能會造成執行時錯誤，但並非總是如此：常數 VbStrConv.Katakana 和 VbStrConv.Hiragana 可在安裝日語語言包的非日語系統中使用。 VbStrConv.KatakanaVbStrConv.SimplifiedChineseVbStrConv.NarrowVbStrConv.Wide 此外，任何安裝東亞語言的系統都支援使用常數VbStrConv.WideVbStrConv.Narrow和。

此函式在操作字串時會利用應用程式的文化資訊，使大小寫變更符合應用程式所處的區域。

Important

如果您的應用程式根據比較或大小寫變更操作的結果做出安全性決策，則操作應該使用 String.Compare 方法，並傳遞 Ordinal 或 OrdinalIgnoreCase 作為 comparisonType 參數。 欲了解更多資訊，請參見文化如何影響弦Visual Basic。

Conversion參數設定如下：

列舉成員 說明
VbStrConv.None 不進行轉換
VbStrConv.LinguisticCasing 使用語言規則來分類大小寫，而非預設的檔案系統。 只有在 且 VbStrConv.UpperCaseVbStrConv.LowerCase 的情況下才有效。
VbStrConv.UpperCase 會將字串轉換成大寫字母。
VbStrConv.LowerCase 可將字串轉換為小寫字母。
VbStrConv.ProperCase 將每個字串的首字母轉換為大寫字母。
VbStrConv.Wide * 將字串中的窄（半寬）字元轉換為寬（全寬）字元。 即使輸入字元已經是全寬，轉換仍可使用正規化形式 C。 例如，字串「は ゙」（已是全寬）會被正規化為「ば」。 參見 Unicode 正規化形式。
VbStrConv.Narrow * 將字串中的寬（全寬）字元轉換為窄（半寬）字元。
VbStrConv.Katakana ** 將串中的平假名字轉換為片假名字。
VbStrConv.Hiragana ** 將串中的片假名字轉換成平假名字。
VbStrConv.SimplifiedChinese * 將繁體中文字符轉換為簡體中文。
VbStrConv.TraditionalChinese * 將簡體中文文字轉換為繁體中文。

* 適用於亞洲地區。

** 僅限日本。

備註

這些常數在 .NET Framework 通用語言執行環境中規範。 因此，它們可以在程式碼中任何地方取代實際值。 大多數 可以組合（例如 UpperCase + Wide），除非它們互斥（例如， VbStrConv.Wide + VbStrConv.Narrow）。

以下是有效大小寫的字分隔符：空（Chr$(0)）、水平制表（Chr$(9)）、換Chr$(10)行（）、垂直制表（Chr$(11)）、表單換送（Chr$(12)）、回車（Chr$(13)）、空格（單位元組字元集）（Chr$(32)）。 空間的實際價值，可以是全寬或半寬，會因國家或地區而異，對東亞文化而言有所不同。

適用於

另請參閱