Strings.StrConv(String, VbStrConv, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает строку, преобразованную по мере указания.
public static string StrConv(string str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);static member StrConv : string * Microsoft.VisualBasic.VbStrConv * int -> stringPublic Function StrConv (str As String, Conversion As VbStrConv, Optional LocaleID As Integer = 0) As StringПараметры
- str
- String
Обязательно.
String выражение для преобразования.
- Conversion
- VbStrConv
Обязательно. VbStrConv Член. Значение перечисления, указывающее тип выполняемого преобразования.
- LocaleID
- Int32
Optional. Значение 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.TraditionalChineseVbStrConv.SimplifiedChineseVbStrConv.Katakanaи VbStrConv.Hiragana могут вызывать ошибки во время выполнения при использовании в языковых стандартах, где они не применяются, но не всегда: константы VbStrConv.Katakana и VbStrConv.Hiragana могут использоваться в неяпонской системе с установленным японским языковым пакетом. Кроме того, использование констант VbStrConv.Wide и VbStrConv.Narrow поддерживается в любой системе с установленным языком Восточной Азии.
Эта функция использует сведения о языках и региональных параметрах приложения при управлении строкой, чтобы изменения регистра соответствовали языковому стандарту, в котором используется приложение.
Important
Если ваше приложение принимает решения по безопасности на основе результата операции сравнения или изменения регистра, то операция должна использовать метод String.Compare, и использовать Ordinal или OrdinalIgnoreCase в качестве аргумента comparisonType. Дополнительные сведения см. в разделе и региональные параметры влияют на строки в Visual Basic.
Параметры Conversion аргумента:
| Элемент перечисления | Description |
|---|---|
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
*
|
Преобразует упрощенные китайские символы в традиционный китайский. |
* Применяется к азиатским языковым стандартам.
** Применяется только к Японии.
Note
Эти константы указываются в среде CLR Framework .NET Framework. В результате их можно использовать в любом месте кода вместо фактических значений. Большинство из них можно объединить (например, UpperCase + Wide), за исключением случаев, когда они являются взаимоисключающими (например, VbStrConv.Wide + VbStrConv.Narrow).
Ниже приведены допустимые разделители слов для правильного регистра: Null (), горизонтальная вкладка (Chr$(0)), вертикальная вкладка (Chr$(9)), веб-каналChr$(10) формы (Chr$(11)), возвратChr$(13) каретки (Chr$(12)), пробел (однобайтовый набор символов) (Chr$(32)). Фактическое значение пространства, которое может быть полной или половиной ширины, зависит от страны или региона для восточноазиатских культур.