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

Определение

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

[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 значение по умолчанию.)

Возвращаемое значение

Строка, преобразованная как указанная.

Атрибуты

Исключения

Неподдерживаемые 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 ** Преобразует символы Hiragana в строку в символы Katakana.
VbStrConv.Hiragana ** Преобразует символы Катаканы в строку в символы Hiragana.
VbStrConv.SimplifiedChinese * Преобразует традиционные китайские символы в упрощенный китайский.
VbStrConv.TraditionalChinese * Преобразует упрощенные китайские символы в традиционный китайский.

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

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

Заметка

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

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

Применяется к

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