Public Shared Function StrConv ( _
    str As String, _
    Conversion As VbStrConv, _
    <OptionalAttribute> Optional LocaleID As Integer = 0 _
) As String

Dim str As String
Dim Conversion As VbStrConv
Dim LocaleID As Integer
Dim returnValue As String

returnValue = Strings.StrConv(str, Conversion, LocaleID)

public static string StrConv (
    string str,
    VbStrConv Conversion,
    [OptionalAttribute] int LocaleID
)

public:
static String^ StrConv (
    String^ str, 
    VbStrConv Conversion, 
    [OptionalAttribute] int LocaleID
)

public static String StrConv (
    String str, 
    VbStrConv Conversion, 
    /** @attribute OptionalAttribute() */ int LocaleID
)

public static function StrConv (
    str : String, 
    Conversion : VbStrConv, 
    LocaleID : int
) : String

參數

str

必要項。要轉換的 String 運算式。

Conversion

必要項。VbStrConv 列舉型別 成員。列舉值，指定要執行的轉換類型。

LocaleID

選擇項。如果不同於系統 LocaleID 值，則使用此 LocaleID 值 (系統 LocaleID 值是預設值)。

傳回值

如需詳細資訊，請參閱 Visual Basic 的主題 StrConv 函式。

常數 VbStrConv.Wide、VbStrConv.Narrow、VbStrConv.SimplifiedChinese、VbStrConv.TraditionalChinese、VbStrConv.Katakana 和 VbStrConv.Hiragana 用於不適用的地區設定時，可能會造成執行階段錯誤，但並非一定會造成錯誤：常數 VbStrConv.Katakana 和 VbStrConv.Hiragana 可用於已安裝日文語言套件的非日文系統中。此外，任何有安裝東亞語言的系統上也可支援常數 VbStrConv.Wide 和 VbStrConv.Narrow 的使用。

這個函式在管理字串時使用應用程式的文化特性資訊，讓大小寫變更能夠配合應用程式所使用的地區設定 (Locale) 而適當變更。

安全性注意事項
如果您的應用程式是根據比較或大小寫變更作業的結果作成安全性決策，則該作業應該使用 String.Compare 方法，並傳遞 Ordinal 或 OrdinalIgnoreCase 供 comparisonType 引數使用。如需詳細資訊，請參閱 在 Visual Basic 中文化特性如何影響字串。

Conversion 引數設定如下：

^*：適用於亞洲地區設定。

^**：僅適用於日本。

注意事項
這些常數指定於 .NET Framework Common Language Runtime 內。因此，可以在程式碼中的任何地方使用這些常數，以取代實際值。大部分的這些常數都可以結合起來 (例如 UpperCase + Wide)，但是在彼此互斥時除外 (例如 VbStrConv.Wide + VbStrConv.Narrow)。

下列是適當轉換所用的有效單字分隔符號：Null (Chr$(0))、水平索引標籤 (Chr$(9))、換行字元 (Chr$(10))、垂直索引標籤 (Chr$(11))、換頁字元 (Chr$(12))、歸位字元 (Carriage Return) (Chr$(13))、空格 (單一位元組字元集) (Chr$(32))。空格的實際值 (可以是全形或半形)，會因東亞文化特性的所在國家或地區而異。

此範例會將文字全都轉換成小寫字母。

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

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

.NET Framework