共用方式為

Strings.StrConv 方法

傳回依照指定方式轉換的字串。

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
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 運算式。
  • 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) 而適當變更。

Security note安全性注意事項

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

Conversion 引數設定如下：

列舉型別成員

描述

VbStrConv.None

不執行轉換

VbStrConv.LinguisticCasing

使用語言規則來進行轉換，而非檔案系統 (預設值)。只有 VbStrConv.UpperCase 和 VbStrConv.LowerCase 才有效。

VbStrConv.UpperCase

將字串轉換為大寫字元。

VbStrConv.LowerCase

將字串轉換為小寫字元。

VbStrConv.ProperCase

將字串中每個單字的第一個字母轉換為大寫。

VbStrConv.Wide *

將字串中的半形字元轉換成全形字元。

VbStrConv.Narrow *

將字串中的全形字元轉換成半形字元。

VbStrConv.Katakana **

將字串中的平假名字元轉換成片假名字元。

VbStrConv.Hiragana **

將字串中的片假名字元轉換成平假名字元。

VbStrConv.SimplifiedChinese *

將繁體中文字元轉換成簡體中文。

VbStrConv.TraditionalChinese *

將簡體中文字元轉換成繁體中文。

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

**：僅適用於日本。

Note注意事項

這些常數指定於 .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

支援版本：2.0、1.1、1.0

請參閱

參考

Strings 類別
Strings 成員
Microsoft.VisualBasic 命名空間
ArgumentException

其他資源

StrConv 函式
字串操作摘要
Chr、ChrW 函式
String 資料型別 (Visual Basic)
型別轉換函式

  • Last updated on