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 -> stringstatic member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> stringPublic 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.Katakana ，而且 VbStrConv.Hiragana 可以在安裝日文語言套件的非日文系統中使用。 VbStrConv.Hiragana VbStrConv.Katakana VbStrConv.TraditionalChinese VbStrConv.SimplifiedChinese VbStrConv.Narrow VbStrConv.Wide 此外，在已安裝東亞語言的任何系統上都支援使用 常數 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) 。 空間的實際值可以是完整或半形，依東亞文化特性的國家/地區而有所不同。