Strings.StrConv(String, VbStrConv, Int32) Метод

Определение

Пространство имен:

Microsoft.VisualBasic

Сборка:

Microsoft.VisualBasic.Core.dll

Исходный код:

Strings.vb

Возвращает строку, преобразованную как указано.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
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

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.TraditionalChinese, VbStrConv.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 даже в том случае, если входной символ уже является полноширинным. Например, полноширинная строка "は゛" нормализуется к виду "ば". См. статью Формы нормализации Юникода.
VbStrConv.Narrow *	Преобразует расширенные (полноширивые) символы в строке в узкие (полуширинный) символы.
VbStrConv.Katakana **	Преобразует все символы хирагана в символы катакана.
VbStrConv.Hiragana **	Преобразует все символы катакана в символы хирагана.
VbStrConv.SimplifiedChinese *	Преобразует традиционные китайские символы в китайский (упрощенное письмо).
VbStrConv.TraditionalChinese *	Преобразует символы китайского языка (упрощенное письмо) в китайский (традиционное письмо).

^* Применяется к азиатским языковым стандартом.

^** Применяется только к Японии.

Примечание

Эти константы указываются в платформа .NET Framework среды CLR. В результате их можно использовать в любом месте кода вместо фактических значений. Большинство из них можно объединить (например, ), за исключением случаев, UpperCase + Wideкогда они являются взаимоисключающими (например, VbStrConv.Wide + VbStrConv.Narrow).

Ниже приведены допустимые разделители слов для правильного регистра: NULL (Chr$(0)), горизонтальная табуляция (Chr$(9)), канал строк (Chr$(10)), вертикальная табуляция (Chr$(11)), канал формы (Chr$(12)), возврат каретки (Chr$(13)), пробел (однобайтовый набор символов) (Chr$(32)). Фактическое значение пространства, которое может быть полной или половинной ширины, зависит от страны или региона для восточноазиатских языков и региональных параметров.

См. также раздел

• Chr(Int32)
• ChrW(Int32)
• String
• ArgumentException
• Сводка по работе со строками
• Type Conversion Functions