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

Ссылка

Определение

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

Сборка:: Microsoft.VisualBasic.Core.dll

Сборка:: Microsoft.VisualBasic.dll

Исходный код:: Strings.vb

Исходный код:: Strings.vb

Исходный код:: Strings.vb

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

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

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

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` ^**	Преобразует символы 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)). Фактическое значение пространства, которое может быть полной или половиной ширины, зависит от страны или региона для восточноазиатских культур.

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

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

Chr(Int32)
ChrW(Int32)
String
ArgumentException
Сводка
Функции преобразования типов

Поделиться через