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

  • 参考

定义

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

可选。 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.Narrow、VbStrConv.SimplifiedChinese、VbStrConv.TraditionalChineseVbStrConv.Katakana、 和 VbStrConv.Hiragana 在区域设置中使用时可能会导致运行时错误，但并非始终适用：常量 VbStrConv.Katakana 和 VbStrConv.Hiragana 可在安装了日语语言包的非日语系统中使用。 此外，在安装了东亚语言的任何系统上都支持使用 常量 VbStrConv.Wide 和 VbStrConv.Narrow 。

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

重要

如果应用程序根据比较或大小写更改操作的结果做出安全决策，那么该操作应使用 String.Compare 方法，并将 Ordinal 或 OrdinalIgnoreCase 传递给 comparisonType 参数。 有关详细信息，请参阅 区域性如何影响 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) 。 空间的实际值（可以是全宽或半宽）因东亚区域性的国家/地区而异。

适用于

另请参阅