Функция StrConv
Обновлен: Ноябрь 2007
Возвращает строку, преобразованную как указано.
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, если оно отлично от текущего значения языка и региональных параметров приложения. Более подробные сведения об идентификаторах языков, о языке и региональных параметрах см. в разделе 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* |
Преобразует упрощенные китайские иероглифы в обычные. |
* Относится к азиатским региональным стандартам.
** Относится только к Японии.
.gif "Примечание") Примечание. |
|---|
Эти константы указаны в среде CLR для платформы .NET Framework. Поэтому их можно использовать в коде вместо фактических значений. Большую часть можно совмещать (например, UpperCase + Wide), за исключением взаимоисключающих (например, VbStrConv.Wide + VbStrConv.Narrow). |
Далее приведены допустимые разделители слов для правильного применения регистра: Null Chr$(0)), горизонтальная табуляция (Chr$(9)), переход на новую строку (Chr$(10)), вертикальная табуляция (Chr$(11)), подача страницы (Chr$(12)), возврат каретки (Chr$(13)), пробел (однобайтовый набор знаков) (Chr$(32)). Фактическое значение для пробела, который может быть полной или половинной ширины, зависит от языковой среды страны или региона Восточной Азии.
Исключения
Тип исключения |
Номер ошибки |
Условие |
|---|---|---|
Не поддерживается 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 поддерживается в любой системе с установленным восточно-азиатским языком.
Эта функция использует сведения о языковой среде приложения при обработке строки, чтобы изменения регистра соответствовали языковым стандартам, в которых используется приложение.
.gif "Примечание о безопасности") Примечание о безопасности. |
|---|
Если приложение выполняет решение, связанное с безопасностью, на основе результата сравнения или операции изменения регистра, то нужно использовать метод String.Compare и передать Ordinal или OrdinalIgnoreCase в качестве аргумента comparisonType. Дополнительные сведения см. в разделе Влияние языка и региональных параметров на строки в 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)