Strings.StrConv(String, VbStrConv, Int32) 方法

定义

命名空间:
Microsoft.VisualBasic
程序集:
Microsoft.VisualBasic.Core.dll
程序集:
Microsoft.VisualBasic.dll
Source:
Strings.vb
Source:
Strings.vb
Source:
Strings.vb
Source:
Strings.vb
Source:
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

Optional. 该值 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.Wide、VbStrConv.NarrowVbStrConv.SimplifiedChinese、VbStrConv.TraditionalChinese以及VbStrConv.KatakanaVbStrConv.Hiragana可在不应用的区域设置中使用时会导致运行时错误，但并非总是：常量VbStrConv.Katakana，并且可以VbStrConv.Hiragana在安装了日语包的非日语系统中使用。 此外，在安装了东亚语言的任何系统上都支持使用常量VbStrConv.WideVbStrConv.Narrow。

此函数在操作字符串时使用应用程序的区域性信息，以便大小写更改适用于正在使用应用程序的区域设置。

Important

如果您的应用程序根据比较或大小写转换操作的结果做出安全决策，则该操作应使用 String.Compare 方法，并将 Ordinal 或 OrdinalIgnoreCase 传递给 comparisonType 参数。 有关详细信息，请参阅 区域性如何影响 Visual Basic 中的字符串。

Conversion参数设置包括：

枚举成员 Description
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 * 将简体中文字符转换为繁体中文。

* 适用于亚洲区域设置。

** 仅适用于日本。

注释

这些常量是在 .NET Framework 公共语言运行时中指定的。 因此，可以在代码中的任何位置使用它们来代替实际值。 大多数可以组合（例如， UpperCase + Wide除相互排斥（例如） VbStrConv.Wide + VbStrConv.Narrow外。

下面是用于正确大小写的有效单词分隔符：Null（Chr$(0)）、水平制表符（Chr$(9)）、换行符（Chr$(10)）、垂直制表符（Chr$(11)）、窗体源（Chr$(12)）、回车符（）、空格（Chr$(13)单字节字符集） （Chr$(32)）。 空间的实际值（可以是全宽或半宽）因东亚文化的国家/地区而异。

适用于

另请参阅