Strings.StrConv(String, VbStrConv, Int32) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
傳回依照指定方式轉換的字串。
[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);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> string
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
運算式。
- LocaleID
- Int32
選擇性。 如果不同於系統 LocaleID
值,則使用此 LocaleID
值 (系統 LocaleID
值是預設值)。
傳回
依照指定方式轉換的字串。
- 屬性
例外狀況
不支援的 LocaleID
、Conversion
< 0 或 > 2048,或不支援的指定地區設定轉換。
範例
本範例會將文字轉換成所有小寫字母。
Dim sText As String = "Hello World"
' Returns "hello world".
Dim sNewText As String = StrConv(sText, VbStrConv.LowerCase)
備註
常數 、、、、 和 在不適用的地區設定中使用時,可能會造成運行時錯誤,但不一定:常數,而且可以在已安裝日文語言套件的非日文系統中使用。VbStrConv.Narrow
VbStrConv.Hiragana
VbStrConv.Wide
VbStrConv.Katakana
VbStrConv.SimplifiedChinese
VbStrConv.TraditionalChinese
VbStrConv.Hiragana
VbStrConv.Katakana
此外,在任何已安裝東亞語言的系統上,都支援使用 常數VbStrConv.Wide
VbStrConv.Narrow
。
此函式會在操作字串時使用應用程式的文化特性資訊,讓案例變更適用於使用應用程式的地區設定。
重要
如果您的應用程式根據比較或大小寫變更作業的結果做出安全性決策,則作業應該使用 String.Compare 方法,並傳遞 Ordinal 或 OrdinalIgnoreCase 做為 comparisonType
引數。 如需詳細資訊,請參閱 文化特性如何影響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 * |
將簡體中文字元轉換為繁體中文。 |
* 適用於亞洲地區設定。
** 僅適用於日本。
注意
這些常數是在 common Language Runtime .NET Framework 中指定。 因此,您可以在程式代碼中的任何位置使用它們來取代實際值。 例如,大部分可以合併 (, UpperCase + Wide
例如) ,除非它們是互斥的 (,例如) VbStrConv.Wide + VbStrConv.Narrow
。
以下是適當大小寫的有效單字分隔符:Null (Chr$(0)
) 、水平索引標籤 (Chr$(9)
) 、換行 Chr$(10)
字元 () 、垂直製表 Chr$(11)
符 () 、表單摘要 Chr$(12)
() 、歸位 Chr$(13)
字元 () 、空格 (單位元組字元集) (Chr$(32)
) 。 空間的實際值可以是完整或半角,會因東亞文化特性的國家/地區而有所不同。
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應