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 ** |
Преобразует все символы хирагана в символы катакана. |
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)
). Фактическое значение пространства, которое может быть полной или половинной ширины, зависит от страны или региона для восточноазиатских языков и региональных параметров.
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по