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

定义

返回按指定转换的字符串。

[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 值为默认值。

返回

已按指定转换的字符串。

属性

例外

不支持 LocaleIDConversion< 0 或 > 2048,或指定区域设置不支持的转换。

示例

此示例将文本转换为所有小写字母。

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

注解

常量 VbStrConv.WideVbStrConv.NarrowVbStrConv.SimplifiedChineseVbStrConv.TraditionalChineseVbStrConv.KatakanaVbStrConv.Hiragana 在不适用的区域设置中使用时可能会导致运行时错误,但并非总是:常量 VbStrConv.KatakanaVbStrConv.Hiragana 可以在安装了日语包的非日语系统中使用。 此外,任何安装了东亚语言的系统上都支持使用常量 VbStrConv.WideVbStrConv.Narrow

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

重要

如果应用程序根据比较或大小写更改操作的结果做出安全决策,则该操作应使用 String.Compare 方法,并为 comparisonType 参数传递 OrdinalOrdinalIgnoreCase。 有关详细信息,请参阅 区域性如何影响 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 * 将简体中文字符转换为繁体中文。

* 适用于亚洲区域设置。

** 仅适用于日本。

注意

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

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

适用于

另请参阅