StrConv 函数

  • 项目

更新：2007 年 11 月

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

Public Shared Function StrConv( _
   ByVal str As String, _
   ByVal Conversion As Microsoft.VisualBasic.VbStrConv, _
   Optional ByVal LocaleID As Integer, 
) As String

参数

  • str
    必选。要转换的 String 表达式。

  • Conversion
    必选。VbStrConv 枚举成员。指定要执行的转换类型的枚举值。

  • LocaleID
    可选。为 LocaleID 的值，如果它与应用程序的当前区域性值不同，则使用该值。有关区域设置 ID 和区域性信息的更多信息，请参见 CultureInfo。（应用程序的当前区域性值为默认值）。

设置

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*

将简体中文字符转换为繁体中文字符。

* 应用于亚洲区域设置。

** 只应用于日本。

说明：

这些常量在 .NET Framework 公共语言运行库中指定。因此，它们可以在代码中任何位置代替实际值使用。大部分常量可以进行组合，例如 UpperCase + Wide，除非它们互斥，例如 VbStrConv.Wide + VbStrConv.Narrow。

下面是正确大小写的有效字词分隔符：null (Chr$(0))、水平制表符 (Chr$(9))、换行 (Chr$(10))、垂直制表符 (Chr$(11))、换页 (Chr$(12))、回车 (Chr$(13))、空格（单字节字符集）(Chr$(32))。对于东亚区域性的不同国家/地区，空格（可以是全角或半角）的实际值将有所不同。

异常

异常类型

错误号

条件

ArgumentException

5

不支持的 LocaleID、Conversion < 0 或 > 2048，或指定的区域设置不支持的转换。

如果正在升级使用非结构化错误处理方式的 Visual Basic 6.0 应用程序，请参见“错误号”一列。（您可以根据 Number 属性（Err 对象） 比较错误号。） 然而，如果可能，应当考虑用 Visual Basic 的结构化异常处理概述替换这种错误控制。

备注

常量 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)。

示例

本例将文本全部转换为小写字母。

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

智能设备开发人员说明

不支持此函数。

要求

命名空间：Microsoft.VisualBasic

**模块：**Strings

**程序集：**Visual Basic 运行库（在 Microsoft.VisualBasic.dll 中）

请参见

参考

字符串操作摘要

Chr、ChrW 函数

String 数据类型 (Visual Basic)

类型转换函数

ArgumentException