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);
[<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 運算式。

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.NarrowVbStrConv.HiraganaVbStrConv.WideVbStrConv.KatakanaVbStrConv.SimplifiedChineseVbStrConv.TraditionalChineseVbStrConv.HiraganaVbStrConv.Katakana 此外，在任何已安裝東亞語言的系統上，都支援使用 常數VbStrConv.WideVbStrConv.Narrow。

此函式會在操作字串時使用應用程式的文化特性資訊，讓案例變更適用於使用應用程式的地區設定。

重要

如果您的應用程式根據比較或大小寫變更作業的結果做出安全性決策，則作業應該使用 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 * 將簡體中文字元轉換為繁體中文。

* 適用於亞洲地區設定。

** 僅適用於日本。

注意

這些常數是在 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)) 。 空間的實際值可以是完整或半角，會因東亞文化特性的國家/地區而有所不同。

適用於

另請參閱