Strings.StrConv(String, VbStrConv, Int32) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回按指定转换的字符串。
[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
表达式。
- LocaleID
- Int32
自选。
LocaleID
值(如果不同于系统 LocaleID
值)。 (系统 LocaleID
值为默认值。
返回
已按指定转换的字符串。
- 属性
例外
不支持 LocaleID
、Conversion
< 0 或 > 2048,或指定区域设置不支持的转换。
示例
此示例将文本转换为所有小写字母。
Dim sText As String = "Hello World"
' Returns "hello world".
Dim sNewText As String = StrConv(sText, VbStrConv.LowerCase)
注解
常量 VbStrConv.Wide
、VbStrConv.Narrow
、VbStrConv.SimplifiedChinese
、VbStrConv.TraditionalChinese
、VbStrConv.Katakana
和 VbStrConv.Hiragana
在不适用的区域设置中使用时可能会导致运行时错误,但并非总是:常量 VbStrConv.Katakana
和 VbStrConv.Hiragana
可以在安装了日语包的非日语系统中使用。 此外,任何安装了东亚语言的系统上都支持使用常量 VbStrConv.Wide
和 VbStrConv.Narrow
。
此函数在操作字符串时使用应用程序的区域性信息,以便大小写更改适用于正在使用应用程序的区域设置。
重要
如果应用程序根据比较或大小写更改操作的结果做出安全决策,则该操作应使用 String.Compare 方法,并为 comparisonType
参数传递 Ordinal 或 OrdinalIgnoreCase。 有关详细信息,请参阅 区域性如何影响 Visual Basic 中的字符串。
Conversion
参数设置如下:
枚举成员 | 描述 |
---|---|
VbStrConv.None |
不执行转换 |
VbStrConv.LinguisticCasing |
使用语言规则进行大小写,而不是文件系统(默认值)。 仅对 VbStrConv.UpperCase 和 VbStrConv.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)
)。 空间的实际值(可以是全宽或半宽)因东亚文化的国家/地区而异。