Strings.StrConv(String, VbStrConv, Int32) Strings.StrConv(String, VbStrConv, Int32) Strings.StrConv(String, VbStrConv, Int32) Method

Определение

Возвращает строку, преобразованную как указано.Returns a string converted as specified.

public static string StrConv (string str, Microsoft.VisualBasic.VbStrConv Conversion, int LocaleID = 0);
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 String

Обязательный.Required. Преобразуемое выражение String.String expression to be converted.

Conversion
VbStrConv VbStrConv VbStrConv

Обязательный.Required. Член VbStrConv.VbStrConv member. Значение перечисления, задающее тип выполняемого преобразования.The enumeration value specifying the type of conversion to perform.

LocaleID
Int32 Int32 Int32

Необязательный параметр.Optional. Значение LocaleID, если оно отличается от системного значения LocaleID.The LocaleID value, if different from the system LocaleID value. (Системное значение LocaleID является значением по умолчанию.)(The system LocaleID value is the default.)

Возвраты

Строка, преобразованная как указано.A string converted as specified.

Исключения

Значение LocaleID не поддерживается, Conversion < 0 или > 2048, либо конверсия не поддерживается для указанного языкового стандарта.Unsupported LocaleID, Conversion < 0 or > 2048, or unsupported conversion for specified locale.

Примеры

В этом примере текст преобразуется во все строчные буквы.This example converts text into all lowercase letters.

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 можно использовать в неяпонской системе с японским языком. Пакет установлен.The constants VbStrConv.Wide, VbStrConv.Narrow, VbStrConv.SimplifiedChinese, VbStrConv.TraditionalChinese, VbStrConv.Katakana, and VbStrConv.Hiragana can cause run-time errors when used in locales where they do not apply, but not always: the constants VbStrConv.Katakana and VbStrConv.Hiragana can be used in a non-Japanese system with the Japanese Language Pack installed. Кроме того, использование констант VbStrConv.Wide и VbStrConv.Narrow поддерживается в любой системе с установленным языковым языком Восточной Азии.In addition, use of the constants VbStrConv.Wide and VbStrConv.Narrow is supported on any system with an East Asian language installed.

Эта функция использует сведения о языке и региональных параметрах приложения при обработке строки, чтобы изменения регистра соответствовали языковому стандарту, в котором используется приложение.This function uses the application's culture information when manipulating the string so that the case changes are appropriate for the locale in which the application is being used.

Важно!

Если приложение принимает решения по обеспечению безопасности на основе результатов операции сравнения или изменения регистра, то операция должна использовать метод String.Compare и передать Ordinal или OrdinalIgnoreCase для аргумента comparisonType.If your application makes security decisions based on the result of a comparison or case-change operation, then the operation should use the String.Compare method, and pass Ordinal or OrdinalIgnoreCase for the comparisonType argument. Дополнительные сведения см. в разделе влияние языка и региональных параметров на строки в Visual Basic.For more information, see How Culture Affects Strings in Visual Basic.

Параметры аргумента Conversion:The Conversion argument settings are:

Элемент перечисленияEnumeration member ОписаниеDescription
VbStrConv.None Преобразование не выполняетсяPerforms no conversion
VbStrConv.LinguisticCasing Использует лингвистические правила для регистра, а не для файловой системы (по умолчанию).Uses linguistic rules for casing, rather than File System (default). Допустимо только для VbStrConv.UpperCase и VbStrConv.LowerCase.Valid with VbStrConv.UpperCase and VbStrConv.LowerCase only.
VbStrConv.UpperCase Преобразует строку в верхний регистр.Converts the string to uppercase characters.
VbStrConv.LowerCase Преобразует строку в нижний регистр.Converts the string to lowercase characters.
VbStrConv.ProperCase Преобразует первую букву каждого слова в строке в верхний регистр.Converts the first letter of every word in string to uppercase.
VbStrConv.Wide *VbStrConv.Wide * Преобразует узкие (полуширинные) символы в строке в широкие (полноширинные) символы.Converts narrow (half-width) characters in the string to wide (full-width) characters. Преобразование может использовать форму нормализации C даже в том случае, если входной символ уже является полноширинным.The conversion may use Normalization Form C even if an input character is already full-width. Например, полноширинная строка "は゛" нормализуется к виду "ば".For example, the string "は゛" (which is already full-width) is normalized to "ば". См. статью Формы нормализации Юникода.See Unicode normalization forms.
VbStrConv.Narrow *VbStrConv.Narrow * Преобразует широкие (полноширинные) символы в строке для узких символов (половинной ширины).Converts wide (full-width) characters in the string to narrow (half-width) characters.
VbStrConv.Katakana **VbStrConv.Katakana ** Преобразует все символы хирагана в символы катакана.Converts Hiragana characters in the string to Katakana characters.
VbStrConv.Hiragana **VbStrConv.Hiragana ** Преобразует все символы катакана в символы хирагана.Converts Katakana characters in the string to Hiragana characters.
VbStrConv.SimplifiedChinese *VbStrConv.SimplifiedChinese * Преобразует традиционные китайские иероглифы в упрощенный китайский.Converts Traditional Chinese characters to Simplified Chinese.
VbStrConv.TraditionalChinese *VbStrConv.TraditionalChinese * Преобразует символы упрощенного китайского языка в традиционный китайский.Converts Simplified Chinese characters to Traditional Chinese.

* Применяется к азиатским языкам.* Applies to Asian locales.

** Применяется только к Японии.** Applies to Japan only.

Примечание

Эти константы указываются в .NET Framework среде CLR.These constants are specified in the .NET Framework common language runtime. В результате их можно использовать в любом месте кода вместо фактических значений.As a result, they can be used anywhere in your code in place of the actual values. Большинство можно объединить (например, UpperCase + Wide), за исключением случаев, когда они являются взаимоисключающими (например, VbStrConv.Wide + VbStrConv.Narrow).Most can be combined (for example, UpperCase + Wide), except when they are mutually exclusive (for example, VbStrConv.Wide + VbStrConv.Narrow).

Ниже приведены допустимые разделители слов для правильного регистра: NULL (Chr$(0)), горизонтальная табуляция (Chr$(9)), перевод строки (Chr$(10)), вертикальная табуляция (Chr$(11)), перевод страницы (Chr$(12)), возврат каретки (Chr$(13)), пробел (однобайтовый набор символов) (Chr$(32)).The following are valid word separators for proper casing: Null (Chr$(0)), horizontal tab (Chr$(9)), line feed (Chr$(10)), vertical tab (Chr$(11)), form feed (Chr$(12)), carriage return (Chr$(13)), space (single-byte character set) (Chr$(32)). Фактическое значение пробела, которое может быть полной или половинной ширины, зависит от страны или региона для восточноазиатских языков и региональных параметров.The actual value for a space, which can be full or half width, varies by country/region for East Asian cultures.

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

Дополнительно