閱讀英文

共用方式為

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

  • 參考

定義

命名空間:
Microsoft.VisualBasic
組件:
Microsoft.VisualBasic.Core.dll
組件:
Microsoft.VisualBasic.dll
來源:
Strings.vb
來源:
Strings.vb
來源:
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);

參數

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。 例如，字串 「は ゙」 （已是全角） 會正規化為 “ば”。 請參閱Unicode 正規化表單。
VbStrConv.Narrow * 將字串中的寬字元（全角）字元轉換為窄（半角）字元。
VbStrConv.Katakana ** 將字串中的平假名字符轉換為片假名字符。
VbStrConv.Hiragana ** 將字串中的片假名字符轉換為平假名字符。
VbStrConv.SimplifiedChinese * 將繁體中文字元轉換成簡體中文。
VbStrConv.TraditionalChinese * 將簡體中文字元轉換成繁體中文。

* 適用於亞洲地區設定。

** 僅適用於日本。

注意

這些常數是在 .NET Framework Common Language Runtime 中指定。 因此，您可以在程式代碼中的任何位置使用它們來取代實際值。 大多數都可以合併（例如，UpperCase + Wide），除非它們互斥（例如，VbStrConv.Wide + VbStrConv.Narrow）。

以下是適當大小寫的有效字分隔符：Null（Chr$(0)）、水平製表符（Chr$(9)）、換行符（Chr$(10)）、垂直製表元（Chr$(11)）、表單摘要（Chr$(12)）、歸位字元（Chr$(13)）、空格（單位元組字元集）（Chr$(32)）。 空間的實際值，可以是完整或半寬，依東亞文化的國家/地區而有所不同。

適用於

產品 版本
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

另請參閱