Функция 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*

Преобразует упрощенные китайские иероглифы в обычные.

*   Относится к азиатским региональным стандартам.

**   Относится только к Японии.

cd7w43ec.alert_note(ru-ru,VS.90).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)). Фактическое значение для пробела, который может быть полной или половинной ширины, зависит от языковой среды страны или региона Восточной Азии.

Исключения

Тип исключения

Номер ошибки

Условие

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 поддерживается в любой системе с установленным восточно-азиатским языком.

Эта функция использует сведения о языковой среде приложения при обработке строки, чтобы изменения регистра соответствовали языковым стандартам, в которых используется приложение.

cd7w43ec.alert_security(ru-ru,VS.90).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)

См. также

Ссылки

Сводка по работе со строками

Функции Chr, ChrW

Строковый тип данных (String) (Visual Basic)

Функции преобразования типов

ArgumentException